Skip to main content
POST
/
v1
/
check-firstin
curl -X POST https://api.vouchmark.com/v1/check-firstin \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"companyId":"cmp_aBcD..."}'

{
  "success": true,
  "message": "TIN verification initiated successfully",
  "jobId": "1234",
  "company": {
    "id": "cmp_aBcD...",
    "companyName": "TEKCIFY TECHNOLOGIES LTD",
    "rcNumber": "8511136",
    "firsTinPending": 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.

Queues a job that resolves the company’s TIN via the JTB taxpayer API. The result is written back to the company record asynchronously — poll GET /v1/dashboard/my-companies?id={companyId} for completion.

​
Body

​
companyId
string
required

​
Behaviour

  • If the company already has a firsTin, the endpoint returns success: true immediately.
  • If a job is genuinely in flight, returns 400 ALREADY_IN_PROGRESS.
  • If the pending flag is stale (worker crashed, upstream was unreachable), the endpoint resets the flag and re-queues automatically.
curl -X POST https://api.vouchmark.com/v1/check-firstin \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"companyId":"cmp_aBcD..."}'

{
  "success": true,
  "message": "TIN verification initiated successfully",
  "jobId": "1234",
  "company": {
    "id": "cmp_aBcD...",
    "companyName": "TEKCIFY TECHNOLOGIES LTD",
    "rcNumber": "8511136",
    "firsTinPending": true
  }
}

​
Errors

StatusCodeWhen
400RC_REQUIREDThe company has no RC number on file.
400ALREADY_IN_PROGRESSA job is currently running for this company.
404COMPANY_NOT_FOUNDThe company doesn’t exist or you don’t own it.