Tax Identification Number (TIN) Verification

This endpoint allows you to verify the validity of a Tax Identification Number (TIN).

Endpoint: POST {baseurl}/v1/api/verification/tin

Request Body

Parameter	Type	Required	Description
`country`	`string`	Yes	The country code (e.g., "NGA" for Nigeria).
`reference`	`string`	Yes	A unique reference for the verification request.
`verificationLevel`	`string`	Yes	The level of verification to perform (e.g., "basic").
`tin`	`string`	Yes	The Tax Identification Number to verify.
`customer`	`string`	No	ID of the customer (optional).
`verificationGroup`	`string`	No	ID of the verification group (optional).

Sample Request

curl -X POST "{baseurl}/v1/api/verification/tin" \
-H "Content-Type: application/json" \
-H "x-api-key: {API-KEY}" \
-d '{
    "country": "NGA",
    "reference": "0122333444455555",
    "verificationLevel": "basic",
    "tin": "12345678-00001",
    "customer": "6791457be570f7f292f1fe23",
    "verificationGroup": "6791457be570f7f292f1fe23"
}'

Sample Response

{
    "status": true,
    "responseCode": "00",
    "statusCode": 200,
    "message": "TIN verification successful",
    "data": {
        "tin": "12345678-0001",
        "name": "Acme Corp",
        "registrationDate": "2015-06-15"
    },
    "meta": {
        "statusCode": 200,
        "isValid": true,
        "referenceId": "jkl012",
        "timeStamp": "2023-10-01T12:00:00Z"
    }
}