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

How does it work?

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

Can I validate a VAT number without having to integrate an API?

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

Example:

Sample TIN verification API request:

API Example:

In this case, the number sent was too short. The message is tailored to provide specific guidance where available.

When the result is valid.

As long as the request itself is well-formed, the response will always be returned with a 200 status code, even if the TIN is invalid. If there is a problem 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 must include a tin (tn), token (tk), country (ca) and a operation (op).

---

tin (tn) required

The TIN Number. May contain numbers, letters (lowercase), hyphens, or underscores.

token (tk) required

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

country (ca) required

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

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 NIF's from other countries, you should obtain more information in the API manual at api.tin-check.com

---