Skip to main content
POST
/
v1
/
verifyTin
curl -X POST https://api.vouchmark.com/v1/verifyTin \
  -H "Authorization: Bearer $TOKEN" \
  -F "companyId=cmp_aBcD..." \
  -F "tin=@./tax-clearance.pdf"

{
  "success": true,
  "data": {
    "companyId": "cmp_aBcD...",
    "firsTin": "2522576963525",
    "taxpayerName": "TEKCIFY TECHNOLOGIES LTD",
    "verified": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.vouchmark.com/llms.txt

Use this file to discover all available pages before exploring further.

Use this when automatic resolution via /check-firstin didn’t find a TIN, or when you want to confirm the resolved TIN against the certificate.

​
Form fields

​
companyId
string
required
​
tin
file
required
The Tax Clearance Certificate PDF. ≤ 10 MB. Text-PDF (not a scanned image) preferred for reliable OCR.
curl -X POST https://api.vouchmark.com/v1/verifyTin \
  -H "Authorization: Bearer $TOKEN" \
  -F "companyId=cmp_aBcD..." \
  -F "tin=@./tax-clearance.pdf"

{
  "success": true,
  "data": {
    "companyId": "cmp_aBcD...",
    "firsTin": "2522576963525",
    "taxpayerName": "TEKCIFY TECHNOLOGIES LTD",
    "verified": true
  }
}

​
Suggestions on failure

When OCR succeeds but doesn’t match, the response includes suggestions — likely candidate values pulled from the document. The dashboard shows them as a chooser so the owner can confirm. 
{
  "success": false,
  "message": "Could not verify TIN from the uploaded certificate.",
  "suggestions": ["2522576963525", "2522576963"]
}