Verifications
Get CAC verification status
Read the per-document submission status for a company’s CAC verification.
GET
Returns the status of each CAC document submitted for a company. This reflects the document submission and verification state held on the company record, not a live CAC registry lookup. Use it to poll after submitting documents to Verify CAC documents. You must own the company.
Path
The company whose document statuses you want.
Response
The response uses the standard envelope{ success, message, data }. data.documents is keyed by document, and every entry is the uniform verification shape: verified (boolean), status, and a reason (null until set). status is one of verified, pending, failed, or not_submitted, and verified is true only when status is verified.
Errors
Errors use the same envelope withsuccess: false and a message.
| Status | Body | When |
|---|---|---|
400 | { "success": false, "message": "Company ID is required" } | companyId missing. |
404 | { "success": false, "message": "Company not found" } | No company matches companyId. |
403 | { "success": false, "message": "You do not have permission to view this company's verification status" } | You do not own the company. |
500 | { "success": false, "message": "Failed to retrieve verification status" } | Unexpected error. |
