API TIN Check for developers

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:

tin-check-result

Sample TIN Check API request:

https://api.tin-check.com/api.php
? op = tc
& tk = 233445cd63415d34153324tw65
& ca = pt
& tn = 999999990

Sample API responses:

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

{
"result": invalid,
"details": {
"tin":"999999990",
"country":"Portugal (PT)",
"type":"-"
},
"credits": {
"used":"1",
"left":"100000"
}
}

When the result is valid.

{
"result": valid,
"details": {
"tin":"999999990",
"country":"Portugal (PT)",
"type":"Legal person"
},
"credits": {
"used":"1",
"left":"100000"
}
}

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.

Countries Code (ca) TIN Check (tc) TIN Lookup (tl) VAT Check (vc)
Andorra ad
United Arab Emirates ae
Albania al
Armenia am
Angola ao
Argentina ar
Austria at
Australia au
Aruba aw
Azerbaijan az
Bosnia And Herzegovina ba
Bangladesh bd
Belgium be
Bulgaria bg
Brunei Darussalam bn
Bolivia bo
Brazil br
Belarus by
Belize bz
Canada ca
Switzerland ch
Chile cl
China cn
Colombia co
Costa Rica cr
Curacao cw
Cyprus cy
Czech Republic cz
Germany de
Denmark dk
Dominican Republic do
Ecuador ec
Estonia ee
Spain es
Finland fi
Faroe Islands fo
France fr
Guernsey gg
Greenland gl
Greece gr
Guatemala gt
Hong Kong hk
Croatia hr
Hungary hu
Indonesia id
Ireland ie
Israel il
Isle Of Man im
India in
Iceland is
Italy it
Jersey je
Japan jp
South Korean kr
Kuwait kw
Kazakhstan kz
Saint Lucia lc
Liechtenstein li
Lithuania lt
Luxembourg lu
Latvia lv
Monaco mc
Moldova md
Marshall Islands mh
Macedonia mk
Macao mo
Malta mt
Mauritius mu
Mexico mx
Malaysia my
Mozambique mz
Netherlands nl
Norway no
Nauru nr
New Zealand nz
Panama pa
Peru pe
Philippines ph
Pakistan pk
Poland pl
Portugal pt
Paraguay py
Romania ro
Serbia rs
Russia ru
Saudi Arabia sa
Seychelles sc
Sweden se
Singapore sg
Slovak Republic sk
Slovenia sl
San Marino sm
El Salvador sv
Thailand th
Turkey tr
Trinidad And Tobago tt
Taiwan tw
Ukraine ua
United Kingdom gb
United States us
Uruguay uy
Venezuela ve
Vietnam vn
Samoa ws
South Africa za


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