Developer API

TIN Check API for secure tax identity validation

Integrate tax identification number validation into onboarding, billing, compliance and customer verification workflows using a simple HTTP API with JSON responses.

Create API account View documentation

Built for professional validation workflows

Start with free test credits, generate your API token in the restricted area, and validate TIN numbers across supported jurisdictions.

100+ Countries

JSON Responses

HTTP Standard codes

How it works

A simple setup flow for teams that need reliable tax number validation in their systems.

Create account

Generate token

Access the restricted dashboard and generate your API token following the API manual.

Send requests

Submit the operation, token, country code and TIN number to receive a structured JSON result.

Sample API request

The API uses query parameters and returns JSON-encoded responses.

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

Sample API responses

Invalid result

When a TIN is invalid, the API returns the submitted details and remaining credit information.

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

Valid result

When the submitted TIN is valid, the response identifies the result and available type information.

{
  "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 usually be returned with a 200 status code, even if the TIN is not valid. If the request is malformed, for example with a missing country code, a 4XX or 5XX status code may be returned.

Query parameters

At minimum, each request should include a TIN number, token, country code and operation.

tin / tn required

The tax identification number. It may contain numbers, lowercase letters, dashes or underscores.

token / tk required

Your API token generated inside the restricted area.

country / ca required

A two-letter country code based on ISO country code standards.

operation / op required

The operation code. Examples: tc for TIN Check, tl for TIN Lookup, vc for VAT Check.

Manual validation without API integration

You can validate TIN numbers without integrating the API. Create an account and access the restricted area to use the manual validator.

Access restricted area
TIN Check validation result

Validator availability by country

The following countries are currently supported by the TIN validation API.

Country	Code ca	TIN Check tc	TIN Lookup tl	VAT Check vc
Andorra	ad
United Arab Emirates	ae
Anguilla	ai
Albania	al
Armenia	am
Angola	ao
Argentina	ar
Austria	at
Australia	au
Aruba	aw
Azerbaijan	az
Bosnia And Herzegovina	ba
Barbados	bb
Bangladesh	bd
Belgium	be
Bulgaria	bg
Bahrain	bh
Brunei Darussalam	bn
Bolivia	bo
Brazil	br
Belarus	by
Belize	bz
Canada	ca
Switzerland	ch
Cook Islands	ck
Chile	cl
China	cn
Colombia	co
Costa Rica	cr
Cuba	cu
Cabo Verde	cv
Curacao	cw
Cyprus	cy
Czech Republic	cz
Germany	de
Denmark	dk
Dominica	dm
Dominican Republic	do
Algeria	dz
Ecuador	ec
Estonia	ee
Egypt	eg
Spain	es
Ethiopia	et
Vat One Stop Shop	eu
Finland	fi
Fiji	fj
Faroe Islands	fo
France	fr
United Kingdom	gb
Grenada	gd
Georgia	ge
Guernsey	gg
Ghana	gh
Gibraltar	gi
Greenland	gl
Guinea	gn
Greece	gr
Guatemala	gt
Guinea Bissau	gw
Hong Kong	hk
Honduras	hn
Croatia	hr
Hungary	hu
Indonesia	id
Ireland	ie
Israel	il
Isle Of Man	im
India	in
Iran	ir
Iceland	is
Italy	it
Jersey	je
Jamaica	jm
Japan	jp
Kenya	ke
Kyrgyzstan	kg
Saint Kitts And Nevis	kn
South Korea	kr
Kuwait	kw
Kazakhstan	kz
Lebanon	lb
Saint Lucia	lc
Liechtenstein	li
Sri Lanka	lk
Lithuania	lt
Luxembourg	lu
Latvia	lv
Morocco	ma
Monaco	mc
Moldova	md
Montenegro	me
Marshall Islands	mh
Macedonia	mk
Macao	mo
Malta	mt
Mauritius	mu
Maldives	mv
Malawi	mw
Mexico	mx
Malaysia	my
Mozambique	mz
Nigeria	ng
Nicaragua	ni
Netherlands	nl
Norway	no
Nauru	nr
New Zealand	nz
Oman	om
Panama	pa
Peru	pe
Philippines	ph
Pakistan	pk
Poland	pl
Portugal	pt
Paraguay	py
Qatar	qa
Romania	ro
Serbia	rs
Russia	ru
Rwanda	rw
Saudi Arabia	sa
Solomon Islands	sb
Seychelles	sc
Sweden	se
Singapore	sg
Slovenia	si
Slovak Republic	sk
San Marino	sm
Senegal	sn
Sao Tome And Principe	st
El Salvador	sv
Thailand	th
Tajikistan	tj
Turkmenistan	tm
Tunisia	tn
Turkey	tr
Trinidad And Tobago	tt
Taiwan	tw
Ukraine	ua
Uganda	ug
United States	us
Uruguay	uy
Uzbekistan	uz
Venezuela	ve
Vietnam	vn
Samoa	ws
South Africa	za
Zambia	zm

For TINs from other countries, consult the API manual inside the restricted area at api.tin-check.com.