Sign in

v1

latestOpenAPI 3.0.02026-07-2436163302.7 KB
Instant Lookup

Find a tax identification number

This endpoint allows you to request a validation of the Tax Identification Number and get the response instantly. In order to do so, our system needs a country of the client (ISO code) and a tax identification number of the client.

post/instant-lookup/v1/find

Request body

country_iso_code'pt' | 'br' | 'be' | 'pl' | 'fr' | 'co' | 'de' | 'es' required
  • Country code in ISO 3166-1 alpha-2 format of the company whose TIN is being validated (e.g., pt for Portugal)
tax_identification_numberstring required

Tax Identification Number (VAT ID, GST ID, etc.) expressed as a string

Example request

{
  "country_iso_code": "br",
  "tax_identification_number": "100070008"
}

Response

The requested TIN was found in our database.

found_tax_identification_numberstring
found_in_official_database'yes' | 'no'
tax_registered'yes' | 'no' | 'unknown' | 'not_applicable'

Specifies whether the TIN was identified in a given government database and whether this identified TIN is currently registered for VAT/GST.

format'valid' | 'not_valid'

Specifies whether the format/checksum of a given TIN is correct (eg. TIN in country X has 10 digits starting with 4 and ending with 9)

namestring

A company name acquired from online database

business_status'active' | 'inactive' | 'unknown'

Specifies whether the company identified by its TIN is currently active in the relevant government register, regardless of whether it is registered for VAT/GST.

is_business'yes' | 'no' | 'unknown' | 'not_applicable'

Specifies whether the taxpayer is an individual, or a legal entity.

legal_entity_typestring

It represents the legal entity type of the taxpayer, the values depend on the country. Some examples:

  • Public Limited Company
  • Private Limited Company
  • Limited Liability Partnership
  • General Partnership
  • Joint Stock Company
registration_type'Regular' | 'Composition' | 'Special Economic Zone' | 'Casual Taxable Person' | 'Unknown' | 'Non Resident Online Services Provider' | 'Registered' | 'Exempt' | 'Final Consumer' | 'Monotributo' | 'Input Service Distributor (ISD)' | 'SEZ Developer' | 'Tax Deductor' | 'Non Resident Foreign Taxpayer' | 'UN Bodies, Embassies and Other Notified Persons' | 'Tax Collector (Electronic Commerce Operator)' | 'Temporary' | 'According to §4 of the VAT Act' | 'According to §4b of the VAT Act' | 'According to §7 of the VAT Act' | 'According to §7a of the VAT Act' | 'Plátce' | 'Identifikovaná osoba' | 'Normal Trimestral' | 'Normal Trimestral por Opção' | 'Normal Mensal' | 'Normal Mensal por Opção' | 'Isenção Artº 53' | 'Isenção Artº 9' | 'Reg. Esp. Peq. Retalhistas' | 'Não Sujeito' | 'Reg. Especial Tributação' | 'Aquisições Intracomunitárias' | 'Micro' | 'Small' | 'Medium' | 'Large'

Type of tax registration.

registration_datestring date

Date at which the entity became registered for indirect tax as shown in the official database.

de_registration_datestring date

Date at which the entity became deregistered for indirect tax as shown in the official database.

addressstring
tax_registered_in_vies'yes' | 'no' | 'unknown'

Specifies whether the TIN is currently registered for VAT/GST in VIES.

country_specificobject
last_updatedstring date-time

Date at which the entity was last checked against official source and updated.

Example response

{
  "name": "ACME",
  "registration_date": "2017-07-20",
  "de_registration_date": "2017-07-20",
  "address": "Tower A DLF Tower, 4th Floor, DLF INFINTY TOWER, Sector 25A, Gurugram, Haryana, 122002",
  "last_updated": "2025-01-28T14:13:37.605Z",
  "errors": [
    {
      "message": "json request could not be read"
    }
  ]
}