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).
identity	string	Yes	A unique identifier for the verification request.
tin	string	Yes	The Tax Identification Number to verify.

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",
        "identity": "6791457be570f7f292f1fe23",
        "tin": "12345678-0001"
    }'

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