# Tax Identification Number

{% hint style="info" %}
Please note that when using your test key, Our test company persona is **John Doe** and the corporate Tax Identification Number is 00000000-0000**.**
{% endhint %}

## Verify TIN

<mark style="color:blue;">`GET`</mark> `https://vapi.verifyme.ng/v1/verifications/identities/tin/:ref`

#### Headers

| Name          | Type   | Description                         |
| ------------- | ------ | ----------------------------------- |
| Authorization | string | Authorization Header - Bearer Token |

{% tabs %}
{% tab title="200 " %}

```
{
    "status": "success",
    "data": {
        "tin": "00000000-0000",
        "taxpayerName": "John Doe",
        "cacRegNo": "RC18*****",
        "entityType": "00000000-0000",
        "jittin": "",
        "taxOffice": "Tax Office Address",
        "phone": "090********",
        "email": "johndoe@gmail.com"
    }
}
```

{% endtab %}

{% tab title="400 Invalid TIN format" %}

```
{
    "statusCode": 400,
    "error": "Bad Request",
    "message": "Invalid TIN Format. Valid Tin format => XXXXXXXX-XXXX"
}
```

{% endtab %}

{% tab title="404 TIN not found" %}

```
{
    "statusCode": 404,
    "error": "Not Found",
    "message": "Company with provided TIN details not found"
}
```

{% endtab %}
{% endtabs %}