The TIN Check API makes it easy to validate TIN numbers for more than 100 countries. The API returns JSON-encoded responses, and uses standard HTTP response codes.

How it works?

You must create your account here and you will receive 10 free credits to be able to make the first tests.
To be able to make the first request, you must generate the Token as indicated in the API manual on the restricted area.

Can I validate a TIN number without needing to integrate an API?

Yes, but you must create your account here and at restricted area will have access to a manual validator of TIN number.

Example:

Sample TIN Check API request:

Sample API responses:

In this case, the number submitted was too short. The message adapts to provide specific guidance where available.

When the result is valid.

As long as the request itself is properly formatted, the response will always be returned with a 200 status code, even if the TIN number is not valid. If there is an issue with the request itself (for example, a missing country code) a 4XX or 5XX status code will be returned.

Query parameters

At a minimum, the query should include a tin (tn), token (tk), country (ca) and a operation (op).

---

tin (tn) required

The TIN Number. It may contain numbers, letters (lowercase) dashes, or underscores.

token (tk) required

The Token. It may contain numbers, letters (lowercase).

country (ca) required

A two-letter country code, as defined in the ISO standard

operation (op) required

The operation. can contain only 2 letters (lowercase). ex. (tc, tl, vc)

Validator Availability by Country

The following is a list of countries currently supported by our TIN validation API.

For TIN's from other countries you should get more information in the API manual at api.tin-check.com