Sign in

v1

latestOpenAPI 3.0.02026-07-2436163302.7 KB
Lookup V2

Request a TIN search

This endpoint allows you to search for a business or entity by name within a given country. The system returns a list of matching results, each enriched with tax registration details.

post/lookup/v2/single-searches

Request body

country_iso_code'ar' | 'au' | 'be' | 'bg' | 'br' | 'ca' | 'ch' | 'cl' | 'co' | 'de' | 'dk' | 'do' | 'ec' | 'ee' | 'es' | 'fi' | 'fr' | 'gb' | 'gr' | 'hr' | 'hu' | 'in' | 'it' | 'lt' | 'lv' | 'mx' | 'no' | 'nz' | 'pe' | 'pl' | 'pt' | 'ro' | 'se' | 'sg' | 'si' | 'sk' | 'th' | 'vn' | 'za' required

Country code in ISO 3166-1 alpha-2 format of the company to search for (e.g., au for Australia, hr for Croatia)

querystring required

The company name or keyword to search for.

external_idstring

An additional reference identifier you can provide - typically, the identifier used in your own system. You can use this to match results back to your own data.

Example request

{
  "country_iso_code": "au",
  "query": "Fonoa Technologies",
  "additional_parameters": {
    "address": "Barrow Street Dublin 4"
  }
}

Response

The TIN search has been accepted and is running. Use the URL in search_result_url to poll for results.

status'running' required
search_result_urlstring uri required

Example response

{
  "search": {
    "tin_search_id": "b470a195-8e83-4d89-b4a7-4d389ac358a4",
    "country_iso_code": "cl",
    "query": "Fonoa Technologies",
    "requested_at": "2024-01-15T10:30:00.000Z",
    "additional_parameters": {
      "address": "Barrow Street Dublin 4"
    }
  },
  "search_result_url": "https://api-demo.fonoa.com/lookup/v2/single-searches/b470a195-8e83-4d89-b4a7-4d389ac358a4"
}