Verify A CAC Certificate PDF

Developing

POST

/api/v1/public/documentverification/cac-certificate/pdf

Same check as the CAC certificate image endpoint, but the document is fetched as a PDF and rendered before extraction. Use this when the customer uploads the CAC download rather than a photograph. Extraction is AI-assisted while the match score is computed locally, so identical inputs always score identically. Results are cached for 24 hours by document type and payload. The wallet is debited on every call including cache hits, at your configured document verification fee less a 30% discount when your company supplies its own OpenAI or Azure OpenAI key. Note this endpoint returns the responseCode/responseMessage/responseData envelope, not the status/message/data one.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Verification completed. Check responseData.valid for the verdict — a 200 does not mean the document passed.

Bodyapplication/json

🟠400

🟠401

🔴502

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/public/documentverification/cac-certificate/pdf' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "companyName": "Figo Technologies Limited",
    "registrationNumber": "RC1234567",
    "pdfUrl": "https://cdn.example.com/docs/cac.pdf"
}'

Response Example

200 - Example 1

{
    "responseCode": "00",
    "responseMessage": "Document verification completed.",
    "responseData": {
        "valid": true,
        "confidenceScore": 96.4,
        "reason": "Name and ID number match the document."
    }
}

Modified at 2026-08-06 11:58:31

Verify A CAC Certificate Image

Verify A Driver's Licence