Verify Tax Identification Number (TIN)

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

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"
    }
}