curl -X POST https://api.vouchmark.com/v1/verifyJtbTin \
-H "Authorization: Bearer $TOKEN" \
-F "companyId=cmp_aBcD..." \
-F "jtbTin=@./jtb-tin.pdf"
{
"success": true,
"message": "JTB TIN verification successful",
"verificationResult": {
"tinNumber": "2522576963525",
"companyMatch": "MATCH",
"documentValidity": "VALID",
"authenticityScore": 90,
"confidenceScore": 85,
"reason": "Verification completed"
},
"company": {
"id": "cmp_aBcD...",
"companyName": "TEKCIFY TECHNOLOGIES LTD",
"jtbtin": "2522576963525",
"jtbtin_vr": true
}
}
Verifications
Verify JTB TIN
Upload a JTB/FIRS TIN certificate and verify it against the company on file.
POST
/
v1
/
verifyJtbTin
curl -X POST https://api.vouchmark.com/v1/verifyJtbTin \
-H "Authorization: Bearer $TOKEN" \
-F "companyId=cmp_aBcD..." \
-F "jtbTin=@./jtb-tin.pdf"
{
"success": true,
"message": "JTB TIN verification successful",
"verificationResult": {
"tinNumber": "2522576963525",
"companyMatch": "MATCH",
"documentValidity": "VALID",
"authenticityScore": 90,
"confidenceScore": 85,
"reason": "Verification completed"
},
"company": {
"id": "cmp_aBcD...",
"companyName": "TEKCIFY TECHNOLOGIES LTD",
"jtbtin": "2522576963525",
"jtbtin_vr": true
}
}
Upload a Joint Tax Board (JTB) TIN certificate. The document is compared against a reference JTB certificate by the verification model. On a pass, the TIN is written to the company’s
When the document fails the response is
Verification is rate limited to 10 attempts per hour per caller.
vouchmark_tools.tin.jtb record. The request is multipart/form-data and you must own the company.
Form fields
string
required
The company the certificate belongs to.
file
required
The JTB TIN certificate. PDF, JPEG, or PNG, up to 10 MB.
curl -X POST https://api.vouchmark.com/v1/verifyJtbTin \
-H "Authorization: Bearer $TOKEN" \
-F "companyId=cmp_aBcD..." \
-F "jtbTin=@./jtb-tin.pdf"
Response
{
"success": true,
"message": "JTB TIN verification successful",
"verificationResult": {
"tinNumber": "2522576963525",
"companyMatch": "MATCH",
"documentValidity": "VALID",
"authenticityScore": 90,
"confidenceScore": 85,
"reason": "Verification completed"
},
"company": {
"id": "cmp_aBcD...",
"companyName": "TEKCIFY TECHNOLOGIES LTD",
"jtbtin": "2522576963525",
"jtbtin_vr": true
}
}
400 with verificationResult and suggestions.
Failed
{
"success": false,
"message": "JTB TIN verification failed",
"verificationResult": {
"tinNumber": "NOT_FOUND",
"companyMatch": "MATCH",
"documentValidity": "VALID",
"authenticityScore": 30,
"confidenceScore": 40,
"reason": "Could not confirm the certificate"
},
"suggestions": [
"Ensure the document is a valid JTB/FIRS TIN certificate",
"Check that the company name matches exactly",
"Verify the TIN number is clearly visible",
"Ensure the document is not expired or damaged",
"Try uploading a clearer, higher quality image",
"Verify the document format matches official JTB TIN certificates"
]
}
Errors
| Status | Body | When |
|---|---|---|
400 | { "success": false, "error": "Missing file or company ID" } | The file or companyId was omitted. |
404 | { "success": false, "error": "Company not found" } | No company matches companyId. |
403 | { "success": false, "error": "Access denied. You can only verify your own company." } | You do not own the company. |
500 | { "success": false, "error": "We couldn't process your document right now. Please try again.", "details": "..." } | The model could not process the document. |