# Verify Business Tax ID

This endpoint allows you to validate the Tax ID of different businesses using their registration number.

## Tax ID Verification

<mark style="color:green;">`POST`</mark> `{{baseurl}}/v2/api/verifications/ng/tax-id`

#### Headers

| Name                                    | Type   | Description      |
| --------------------------------------- | ------ | ---------------- |
| token<mark style="color:red;">\*</mark> | String | API secret token |

#### Request Body

| Name                                                 | Type    | Description                                                                                    |
| ---------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------- |
| registrationNumber<mark style="color:red;">\*</mark> | String  | Company registration number with prefix (e.g., RC1234567, BN12345, IT67890, LP12345, LLP12345) |
| isSubjectConsent<mark style="color:red;">\*</mark>   | Boolean | Indicate subject has given consent. <mark style="color:red;">`Must be true`</mark>             |

{% tabs %}
{% tab title="Tax ID Verification Sample Request" %}

```json
{
    "registrationNumber": "RC00000000",
    "isConsent": true
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Found Response" %}

```json
{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "id": "6936ea29bef8043f094809c8",
        "status": "found",
        "businessId": "61d880f1e8e15aaf24558f1a",
        "parentId": null,
        "isConsent": true,
        "type": "ng_company_tax_id_lookup",
        "searchTerm": "RC00000000",
        "name": "John Doe Inc",
        "registrationNumber": "RC00000000",
        "taxId": "0000000000000",
        "country": "NG",
        "requestedAt": "2025-12-08T15:09:30.202Z",
        "createdAt": "2025-12-08T15:09:30.374Z",
        "lastModifiedAt": "2025-12-08T15:09:30.374Z",
        "requestedBy": {
            "firstName": "API",
            "lastName": "User",
            "middleName": "",
            "id": "61d880f1e8e15aaf24558f1c"
        }
    },
    "links": []
}
```

{% endtab %}

{% tab title="Not Found Response" %}

```json
{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "id": "6936e7da73d47f46128f4fea",
        "status": "not_found",
        "businessId": "61d880f1e8e15aaf24558f1a",
        "parentId": null,
        "isConsent": true,
        "type": "ng_company_tax_id_lookup",
        "searchTerm": "RC0418006",
        "name": null,
        "registrationNumber": "RC0418006",
        "taxId": null,
        "country": "NG",
        "requestedAt": "2025-12-08T14:59:46.518Z",
        "createdAt": "2025-12-08T14:59:46.670Z",
        "lastModifiedAt": "2025-12-08T14:59:46.670Z",
        "requestedBy": {
            "firstName": "API",
            "lastName": "User",
            "middleName": "",
            "id": "61d880f1e8e15aaf24558f1c"
        }
    },
    "links": []
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Error Response" %}

```json
{
  "success": false,
  "statusCode": 404,
  "message": "You have attempted to get a resource that does not exist.",
  "name": "ResourceNotFoundError",
  "data": {}
}
```

{% endtab %}
{% endtabs %}