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 nullable

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 nullable required

A more detailed description of the current status.

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-09-27T01:00:32.317986Z",
  "updated_at": "2026-09-27T01:00:32.318023Z"
}

Changes

Changed in 2 of the 12 revisions of this API.48123

Sep 21, 2026fd8c32a19c7f36123See the full diff
- ▲
  response property external_tracking_ref list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property external_tracking_ref list-of-types was widened by adding types null to media type application/json of response 202
  response-property-list-of-types-widened
- ▲
  response property external_tracking_ref list-of-types was widened by adding types null to media type application/json of response 422
  response-property-list-of-types-widened
- ▲
  response property query/city list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property query/city list-of-types was widened by adding types null to media type application/json of response 202
  response-property-list-of-types-widened
- ▲
  response property query/city list-of-types was widened by adding types null to media type application/json of response 422
  response-property-list-of-types-widened
- ▲
  response property query/country list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property query/country list-of-types was widened by adding types null to media type application/json of response 202
  response-property-list-of-types-widened
- ▲
  response property query/country list-of-types was widened by adding types null to media type application/json of response 422
  response-property-list-of-types-widened
- ▲
  response property query/external_tracking_ref list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property query/external_tracking_ref list-of-types was widened by adding types null to media type application/json of response 202
  response-property-list-of-types-widened
- ▲
  response property query/external_tracking_ref list-of-types was widened by adding types null to media type application/json of response 422
  response-property-list-of-types-widened
- ▲
  response property query/postal_code list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property query/postal_code list-of-types was widened by adding types null to media type application/json of response 202
  response-property-list-of-types-widened
- ▲
  response property query/postal_code list-of-types was widened by adding types null to media type application/json of response 422
  response-property-list-of-types-widened
- ▲
  response property query/state_province list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property query/state_province list-of-types was widened by adding types null to media type application/json of response 202
  response-property-list-of-types-widened
- ▲
  response property query/state_province list-of-types was widened by adding types null to media type application/json of response 422
  response-property-list-of-types-widened
- ▲
  response property query/submitted_business_name list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property query/submitted_business_name list-of-types was widened by adding types null to media type application/json of response 202
  response-property-list-of-types-widened
- ▲
  response property query/submitted_business_name list-of-types was widened by adding types null to media type application/json of response 422
  response-property-list-of-types-widened
- ▲
  response property query/submitted_website list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property query/submitted_website list-of-types was widened by adding types null to media type application/json of response 202
  response-property-list-of-types-widened
- ▲
  response property query/submitted_website list-of-types was widened by adding types null to media type application/json of response 422
  response-property-list-of-types-widened
- ▲
  response property status_description list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property status_description list-of-types was widened by adding types null to media type application/json of response 202
  response-property-list-of-types-widened
- ▲
  response property status_description list-of-types was widened by adding types null to media type application/json of response 422
  response-property-list-of-types-widened
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ○
  added subschema #2 to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #2 to the response property anyOf list for the response status
  response-property-any-of-added
Sep 10, 20262478839b1d3f12See the full diff
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history