Industry Discovery

Get Industry Search

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.

get/api/v1/industry-searches/{search_id}

Path parameters

search_idstring uuid required

Response

idstring uuid

The unique identifier of the industry search.

external_tracking_refstring

created_atstring date-time

The date and time when the industry search was created.

updated_atstring 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_descriptionstring required

A more detailed description of the current status.

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-08-14T22:40:18.297Z",
  "updated_at": "2026-08-14T22:40:18.297Z"
}