---
title: "Get Industry Search"
method: GET
path: "/api/v1/industry-searches/{search_id}"
tags: ["Industry Discovery"]
---

# Get Industry Search

`GET /api/v1/industry-searches/{search_id}`

The Get Industry Search endpoint retrieves the status and results of a previously created industry discovery
request. If the discovery is still in progress, the endpoint responds with HTTP 202 (Accepted). When the discovery
is complete, the endpoint responds with HTTP 200 (OK) and returns the discovered industry information,
including name, address, description, and industry classifications (e.g., NAICS, SIC, MCC).

Clients should poll the Get Industry Search endpoint using exponential backoff rather than continuous requests.
We recommend starting with a short delay (2–3 seconds) after the initial 202 response, then doubling the wait
time between each subsequent attempt until reaching a maximum interval (for example, 30 seconds). Continue polling
until the endpoint returns 200 (discovery complete) or until a reasonable overall timeout is reached. This
approach reduces unnecessary load while ensuring timely retrieval of results.

This API requires a valid API key (X-API-KEY) to be provided in the headers and is rate limited to 5
requests per second.

## Path parameters

- `search_id` string, uuid, required

## Response `200`

OK

- BusinessSearch
  - `id` string, uuid — The unique identifier of the industry search.
  - `external_tracking_ref` string
  - `created_at` string, date-time — The date and time when the industry search was created.
  - `updated_at` string, date-time — The date and time when the industry search was last updated.
  - `status` 'PROCESSING' | 'FINISHED' | 'ERROR' | 'QUEUED', required — The current status of the industry search.
  - `status_description` string, required — A more detailed description of the current status.
  - `result` BusinessSearchResult
    - `business_name` string, required — The name of the business.
    - `business_description` string, required — A description of the business.
    - `business_address` string, nullable — The long-form address of the business.
    - `website` string, nullable — The website of the business.
    - `primary_mcc` MCC
      - `code` string, required — The Merchant Category Code.
      - `description` string, required — The description of the Merchant Category.
    - `additional_mccs` MCC[]
      - `code` string, required — The Merchant Category Code.
      - `description` string, required — The description of the Merchant Category.
  - `query` CreateSearchInput, required
    - `submitted_business_name` string, required — The name of the business to search for.
    - `submitted_website` string, nullable — The website of the business to search for.
    - `city` string, nullable — The city where the business is located.
    - `state_province` string, nullable — The state or province where the business is located.
    - `postal_code` string, nullable — The postal code of the business location.
    - `country` string, required — The country where the business is located.
    - `external_tracking_ref` string

## Other responses

- `202` — Accepted
- `204` — No Content
- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/truebiz/apis/truebiz-web-presence-review-api.md) · [All operations](https://skmtc.net/truebiz/apis/truebiz-web-presence-review-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truebiz/truebiz-web-presence-review-api/revisions/22a9a6d3740a/schema)