curl https://api.vouchmark.com/v1/cacVerificationStatus/cmp_aBcD... \
-H "Authorization: Bearer $TOKEN"
{
"success": true,
"message": "Success",
"data": {
"documents": {
"cacert": {
"verified": true,
"status": "verified",
"reason": null
},
"cacReport": {
"verified": false,
"status": "pending",
"reason": null
},
"memart": {
"verified": false,
"status": "failed",
"reason": "The document could not be matched to the registered company"
}
}
}
}
Verifications
Get CAC verification status
Read the per-document submission status for a company’s CAC verification.
GET
/
v1
/
cacVerificationStatus
/
{companyId}
curl https://api.vouchmark.com/v1/cacVerificationStatus/cmp_aBcD... \
-H "Authorization: Bearer $TOKEN"
{
"success": true,
"message": "Success",
"data": {
"documents": {
"cacert": {
"verified": true,
"status": "verified",
"reason": null
},
"cacReport": {
"verified": false,
"status": "pending",
"reason": null
},
"memart": {
"verified": false,
"status": "failed",
"reason": "The document could not be matched to the registered company"
}
}
}
}
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
curl https://api.vouchmark.com/v1/cacVerificationStatus/cmp_aBcD... \
-H "Authorization: Bearer $TOKEN"
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.
{
"success": true,
"message": "Success",
"data": {
"documents": {
"cacert": {
"verified": true,
"status": "verified",
"reason": null
},
"cacReport": {
"verified": false,
"status": "pending",
"reason": null
},
"memart": {
"verified": false,
"status": "failed",
"reason": "The document could not be matched to the registered company"
}
}
}
}
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. |
