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
string
required
The company whose document statuses you want.
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. |