FOfonoa
Instant Lookup

Find a tax identification number

Changed on

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

  • Base URL
    https://api-demo.fonoa.com
  • URL
    https://api-demo.fonoa.com/instant-lookup/v1/find
  • Auth
    API key in header Ocp-Apim-Subscription-Key

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' | 'unknown'

Whether the TIN was found in the official database. For Brazil CPF validations, "unknown" indicates the CPF may exist but the provided date of birth did not match the government records (DOB mismatch), as distinct from "no" which means the CPF itself is invalid.

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' | 'Aquis. Intracom. por Opção' | '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",
  "fuzzy_matching": {
    "name": {
      "matched_field": "name"
    }
  },
  "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"
    }
  ]
}

Changes

  • 893d624efa51Revision changes
    • warning

      added the new Aquis. Intracom. por Opção enum value to the response property for the response status

    • warning

      added the new unknown enum value to the response property for the response status

    • info

      added the new optional request property /

    • info

      added the optional property // to the response with the status