# Verify Business TIN

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

## TIN Verification

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

#### Headers

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

#### Request Body

| Name                                               | Type    | Description                                                                        |
| -------------------------------------------------- | ------- | ---------------------------------------------------------------------------------- |
| tin<mark style="color:red;">\*</mark>              | String  | TIN of the business                                                                |
| isSubjectConsent<mark style="color:red;">\*</mark> | Boolean | Indicate subject has given consent. <mark style="color:red;">`Must be true`</mark> |

{% tabs %}
{% tab title="TIN Verification Sample Request" %}

```json
{
    "tin": "00000000-0000",
    "isConsent": true
}
```

{% endtab %}
{% endtabs %}

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

```json
{
      "success": true,
      "statusCode": 200,
      "message": "success",
      "data": {
          "id": "62663af982b204577a58dd9c",
          "status": "found",
          "businessId": "61d880f1e8e15aaf24558f1a",
          "parentId": null,
          "isConsent": true,
          "type": "tin-lookup",
          "name": "JOHN DOE LTD",
          "registrationNumber": "RC00000000",
          "tin": "00000000-0000",
          "jtbTin": "0000000000",
          "taxOffice": "MSTO ILUPEJU I",
          "email": "johndoe@gmail.co",
          "phone": "08000000000",
          "requestedAt": "2022-04-25T06:08:57.670Z",
          "createdAt": "2022-04-25T06:08:57.845Z",
          "requestedBy": {
              "firstName": "API",
              "lastName": "User",
              "middleName": "",
              "id": "61d880f2e8e15aaf24558f9b"
          }
      },
      "links": []
  }
```

{% endtab %}

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

```json
{
      "success": true,
      "statusCode": 200,
      "message": "success",
      "data": {
          "id": "626636002c1fbe4da972a50d",
          "status": "not_found",
          "businessId": "61d880f1e8e15aaf24558f1a",
          "parentId": null,
          "isConsent": true,
          "type": "tin-lookup",
          "name": null,
          "registrationNumber": null,
          "tin": "20504133-0002",
          "jtbTin": null,
          "taxOffice": null,
          "email": null,
          "phone": null,
          "requestedAt": "2022-04-25T05:47:46.398Z",
          "createdAt": "2022-04-25T05:47:46.782Z",
          "requestedBy": {
              "firstName": "API",
              "lastName": "User",
              "middleName": "",
              "id": "61d880f2e8e15aaf24558f9b"
          }
      },
      "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 %}