v1

latestOpenAPI 3.0.02026-07-2436163302.7 KB

Lookup V2

Get TIN search results

This endpoint returns the results of a previously submitted TIN search request. The status field indicates whether processing is complete:

"running" — the search is still in progress; poll again later.
"completed" — results are available in the search.results array.

get/lookup/v2/single-searches/{id}

Path parameters

idstring uuid required

The tin_search_id value returned by the POST /lookup/v2/single-searches response

Response

The TIN search request was found. Check status to determine whether results are ready.

status'running' | 'completed' required

Example response

{
  "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"
    },
    "results": [
      {
        "tin_search_result_id": "d1e2f3a4-b5c6-7890-abcd-ef1234567890",
        "name": "FONOA TECHNOLOGIES LIMITED",
        "tax_identification_number": "IE3717232WH",
        "registration_date": "2017-07-20",
        "deregistration_date": "2017-07-20",
        "address": "Tower A DLF Tower, 4th Floor, DLF INFINTY TOWER, Sector 25A, Gurugram, Haryana, 122002",
        "fuzzy_matching_similarity_score": 100,
        "address_fuzzy_matching_similarity_score": 62,
        "business_registration_number": "123456",
        "additional_data": {
          "france_siret": "73282932000074",
          "italy_codice_fiscale": "RSSMRA80A01H501U",
          "italy_pec_address": "example@pec.it",
          "brazil_fantasy_name": "FONOA BRAZIL",
          "colombia_check_digit": "7",
          "colombia_large_taxpayer": "GRAN CONTRIBUYENTE",
          "colombia_tin_without_check_digit": "900123456"
        }
      }
    ]
  }
}