Verify Individual Tax ID

Tax ID Verification

POST {{baseurl}}/v2/api/identity/ng/tax-id

Headers

Name	Type	Description
token*	String	API secret token

Request Body

Field	Type	Description
nin*	String	Subject's National Identification Number
isSubjectConsent*	Boolean	Subject has granted consent. Must be true
metadata	Object	Additional metadata passed through to the verification record

Tax ID Verification

The Tax ID Verification is used to resolve and verify an individuals Tax ID using their NIN

Tax ID Verification Sample Request

{
    "nin": "11111111111",
    "isSubjectConsent": true
}

Found Response:

{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "id": "69370e9ebb6732a17ba651df",
        "parentId": null,
        "status": "found",
        "reason": null,
        "dataValidation": false,
        "selfieValidation": false,
        "firstName": "Sarah",
        "lastName": "Doe",
        "dateOfBirth": "1988-04-04",
        "nin": "11111111111",
        "taxId": "0000000000000",
        "taxResidency": "Lagos State",
        "isConsent": true,
        "idNumber": "11111111111",
        "businessId": "61d880f1e8e15aaf24558f1a",
        "type": "taxId",
        "allValidationPassed": true,
        "requestedAt": "2025-12-08T17:45:03.324Z",
        "requestedById": "61d880f1e8e15aaf24558f1c",
        "country": "NG",
        "createdAt": "2025-12-08T17:45:03.512Z",
        "lastModifiedAt": "2025-12-08T17:45:03.512Z",
        "adverseMediaReport": null,
        "amlReport": null,
        "metadata": {},
        "requestedBy": {
            "firstName": "API",
            "lastName": "User",
            "middleName": "",
            "id": "61d880f1e8e15aaf24558f1c"
        }
    },
    "links": []
}

Not Found Response

Error Responses:

HTTP/1.1 402 Payment Required
  {
    "success": false,
    "statusCode": 402,
    "message": "Insufficient fund",
    "name": "PaymentRequiredError",
    "data": {}
}


HTTP/1.1 500 Internal Server Error
{
    "success": false,
    "statusCode": 500,
    "message": "Service unavailable",
    "name": "Error",
    "data": {}
}

HTTP/1.1 403 Forbidden
{
    "success": false,
    "statusCode": 403,
    "message": "Permission denied",
    "name": "UnauthorizedError",
    "data": {}
}