---
title: "Get TIN search results"
method: GET
path: "/lookup/v2/single-searches/{id}"
tags: ["Lookup V2"]
---

# Get TIN search results

`GET /lookup/v2/single-searches/{id}`

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.

## Path parameters

- `id` string, uuid, required

## Response `200`

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

- object
  - `status` 'running' | 'completed', required
  - `search` LookupTinSearchResponse, required — Full TIN search response including results (available once status is "completed").
    - `id` string, uuid, required — Unique identifier of the TIN search request.
    - `country_iso_code` string, required — Customer ISO 3166-1 alpha-2 country code
    - `query` string, required — The search query that was submitted.
    - `requested_at` string, date-time, required — Timestamp when the search was requested.
    - `additional_parameters` LookupTinSearchAdditionalParameters — Optional parameters to refine a TIN search request.
      - `address` string — Address used to narrow the search and score address fuzzy matching.
    - `external_id` string — An additional reference identifier you provided in your request - typically, the identifier used in your own system. You can use this to match results back to your own data.
    - `error_details` object — Error details if the search encountered an error.
      - `code` string
      - `message` string
    - `results` LookupTinSearchResult[], required — List of matching entities found by the search. Empty while the search is still running.
      - `tin_search_result_id` string, uuid, required — Unique identifier of this search result entry.
      - `name` string — Registered name of the entity.
      - `tax_registered` 'yes' | 'no' | 'unknown' | 'not_applicable', required — Specifies whether the TIN was identified in a given government database and whether this identified TIN is currently registered for VAT/GST.
      - `tax_identification_number` string — Tax identification number of the entity.
      - `tax_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.
      - `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.
      - `legal_entity_type` string — 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_date` string, date — Date at which the entity became registered for indirect tax as shown in the official database.
      - `deregistration_date` string, date — Date at which the entity became deregistered for indirect tax as shown in the official database.
      - `address` string
      - `is_business` 'yes' | 'no' | 'unknown' | 'not_applicable' — Specifies whether the taxpayer is an individual, or a legal entity.
      - `fuzzy_matching_similarity_score` number, float — Similarity score (0–100) between the search query and this result's name.
      - `address_fuzzy_matching_similarity_score` number, float — Similarity score (0–100) between the `additional_parameters.address` provided in the request and this result's address.
      - `business_registration_number` string — Company registration number (distinct from the TIN), if available.
      - `additional_data` LookupTinSearchAdditionalData — Country-specific additional data fields returned alongside the TIN search result, if available.
        - `france_siret` string — SIRET number.
        - `italy_codice_fiscale` string — Codice Fiscale.
        - `italy_pec_address` string — Certified email address.
        - `brazil_fantasy_name` string — Fantasy name.
        - `colombia_check_digit` string — Check digit appended to the NIT.
        - `colombia_large_taxpayer` string — Large taxpayer classification.
        - `colombia_tin_without_check_digit` string — NIT without its check digit.

## Other responses

- `400` — Bad Request (usually means the `id` format is invalid)
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/fonoa/apis/fonoa-api.md) · [All operations](https://skmtc.net/fonoa/apis/fonoa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fonoa/fonoa-api/versions/cf0ebc843a3f/schema)