Sign in
Industry Discovery

Create Industry Search

Create Industry Search endpoints allow you to start a new industry discovery request. You provide a business name and location details, and TrueBiz creates a search record. The response includes a unique identifier for the search, which can be used to retrieve the results from the corresponding retrieval endpoint once processing is complete. In addition to the the ID returned in the response body, the full retrieval URL is also included in the Location header sent with the response.

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.

post/api/v1/industry-searches

Request body

submitted_business_namestring required

The name of the business to search for.

submitted_websitestring nullable

The website of the business to search for.

citystring nullable

The city where the business is located.

state_provincestring nullable

The state or province where the business is located.

postal_codestring nullable

The postal code of the business location.

countrystring required

The country where the business is located.

external_tracking_refstring

Response

Accepted

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"
}