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 structured JSON responses.

Create API account View documentation

API overview Built for professional validation workflows

150+ Supported countries

JSON Structured responses

HTTP Standard request model

01 HTTP API

02 JSON responses

03 Token authentication

04 Global validation

Integration process

A straightforward setup for professional systems

Start with test credits, generate your API token inside the restricted area and begin sending validation requests from your internal systems.

01 / 03

Create account

02 / 03

Generate token

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

03 / 03

Send requests

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

Technical documentation

API reference

Core request structure, response examples, required parameters and validator availability are documented below.

Request

Sample API request

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

HTTP Request GET

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

Response format

Sample API responses

Responses contain the validation result, submitted details and credit information.

Invalid result

Invalid

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

JSON response application/json

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

Valid result

Valid

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

JSON response application/json

{
    "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.

Request parameters

Query parameters

At minimum, each request should include a TIN number, API 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

Operation code. Examples: tc for TIN Check, tl for TIN Lookup and vc for VAT Check.

Manual validation

Validate 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

Global coverage

Validator availability by country

The following jurisdictions are currently available through the TIN validation environment.

Country	Code ca	TIN Check tc	TIN Lookup tl	VAT Check vc
Andorra	ad	✓	×	×
United Arab Emirates	ae	✓	×	×
Antigua E Barbuda	ag	✓	×	×
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	✓	✓	×
Benin	bj	✓	×	×
Brunei Darussalam	bn	✓	×	×
Bolivia	bo	✓	×	×
Brazil	br	✓	✓	×
Bahamas	bs	✓	×	×
Belarus	by	✓	×	×
Belize	bz	✓	×	×
Canada	ca	✓	✓	×
Switzerland	ch	✓	✓	×
Côte D’ivoire	ci	✓	×	×
Cook Islands	ck	✓	×	×
Chile	cl	✓	×	×
Cameroon	cm	✓	×	×
China	cn	✓	✓	×
Colombia	co	✓	×	×
Costa Rica	cr	✓	×	×
Cuba	cu	✓	×	×
Cabo Verde	cv	✓	×	×
Curacao	cw	✓	×	×
Cyprus	cy	✓	×	✓
Czech Republic	cz	✓	×	✓
Germany	de	✓	✓	✓
Djibouti	dj	✓	×	×
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	✓	✓	✓
Gabon	ga	✓	×	×
United Kingdom	gb	✓	✓	×
Grenada	gd	✓	×	×
Georgia	ge	✓	×	×
Guernsey	gg	✓	×	×
Ghana	gh	✓	×	×
Gibraltar	gi	✓	×	×
Greenland	gl	✓	×	×
Gambia	gm	✓	×	×
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	✓	×	×
Cambodia	kh	✓	×	×
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	✓	×	×
Mongolia	mn	✓	×	×
Macao	mo	✓	×	×
Mauritania	mr	✓	×	×
Malta	mt	✓	✓	✓
Mauritius	mu	✓	×	×
Maldives	mv	✓	×	×
Malawi	mw	✓	×	×
Mexico	mx	✓	✓	×
Malaysia	my	✓	×	×
Mozambique	mz	✓	✓	×
Namibia	na	✓	×	×
Nigeria	ng	✓	×	×
Nicaragua	ni	✓	×	×
Netherlands	nl	✓	✓	✓
Norway	no	✓	✓	×
Nepal	np	✓	×	×
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	✓	×	×
Suriname	sr	✓	×	×
Sao Tome And Principe	st	✓	×	×
El Salvador	sv	✓	×	×
Thailand	th	✓	×	×
Tajikistan	tj	✓	×	×
Turkmenistan	tm	✓	×	×
Tunisia	tn	✓	×	×
Turkey	tr	✓	✓	×
Trinidad And Tobago	tt	✓	×	×
Taiwan	tw	✓	×	×
Tanzania	tz	✓	×	×
Ukraine	ua	✓	×	×
Uganda	ug	✓	×	×
United States	us	✓	✓	×
Uruguay	uy	✓	×	×
Uzbekistan	uz	✓	×	×
Saint Vincent And The Grenadines	vc	✓	×	×
Venezuela	ve	✓	×	×
Vietnam	vn	✓	×	×
Vanuatu	vu	✓	×	×
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 .

TIN Check API

Ready to integrate TIN validation?

Create an API account, access the restricted documentation environment and begin integrating tax identification validation into your business workflows.

Create API account

TIN-Check.com · Developer API Professional tax identification infrastructure