---
title: "Request a TIN search"
method: POST
path: "/lookup/v2/single-searches"
tags: ["Lookup V2"]
---

# Request a TIN search

`POST /lookup/v2/single-searches`

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.

## Request body

- LookupTinSearchRequest — Request body for submitting a TIN search by company name.
  - `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)
  - `query` string, required — The company name or keyword to search for.
  - `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 can provide - typically, the identifier used in your own system. You can use this to match results back to your own data.

## Response `202`

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

- object
  - `status` 'running', required
  - `search` LookupTinSearchImmediateResponse, required — Representation of a TIN search request that has been accepted and is running.
    - `tin_search_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.
  - `search_result_url` string, uri, required

## Other responses

- `400` — The provided data is not valid. This response will be served when you provide invalid parameters (e.g. unsupported country code).
- `401` — Unauthorized
- `415` — Unsupported Media Type, we only accept application/json
- `500` — Internal Server Error, something went wrong and we are investigating it.

---

[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)