This endpoint provides Tax Identification Number validation results. To access it you need to use an ID returned from the “Request a validation” endpoint. It consists of a validation results and status which can hold 3 states:

  • Completed - validation for that request finished.
  • Running - validation process for that request is still in progress, you should check its results again.
  • Paused - validation process for that request has been paused due to unavailability of local government database. The process will be automatically resumed once our health checks detect the database is back online.

Request example

curl --request GET \
  --url https://api-demo.fonoa.com/Lookup/v1/Validations/v1.BlJPbxQpdWUvFlRUVwAFAgADB18YdHQDUVVTDgQCAFxNDgQFB1QI \
  --header 'Accept: application/json' \
  --header 'Ocp-Apim-Subscription-Key: 8b144782eec54b159917c8c4a367d694'

❗️

We recommend using a 1000 ms delay between two identical GET requests.

To see a list of possible HTTP status codes, please click here.

Response example (200 OK)

{
  {
   "status":"completed"
      "validation":{
      "id":"v1.BlJPbxQpdWUvFlRUVwAFAgADB18YdHQDUVVTDgQCAFxNDgQFB1QI"
      "tin":"EE100070008"
      "country_iso": "ee"
      "company_name":"Telia Eesti AS"
      "format_valid":true
      "tin_exists_online":true
      "requested":"2021-05-06T12:45:50.14Z"
      "last_checked_online":"2021-05-06T12:45:55.057Z"
   }
}

📘

Examples of the request and response

Examples of the request in more programming languages are available in the console pane on the right-hand side. After clicking on the 'Try it' button, you will get a response.

EU TIN Validation

If you are validating an EU TIN, Fonoa will first perform the validation through VIES (TIN database at an EU level), and then, in case the TIN is not available in VIES database, we will automatically go one level deeper and check the TIN via the local government database.

For eg., for an Italian TIN, we’d first check if it exists in VIES, and would then immediately check if it exists in the Italian government database in case it is not active on VIES.

It is not uncommon to have companies who are not registered on VIES but have a valid Tax number in their local government database, which is why we stress this point so much.

Language
Authentication
Header
URL
Click Try It! to start a request and see the response here!