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 nullable

The name of the business to search for. Required (along with an address) if you do not provide submitted_website.

submitted_websitestring nullable

The website of the business to search for. Required unless you provide submitted_business_name together with an address.

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 nullable

The country where the business is located. At least one address field is required when identifying the business by name instead of website.

external_tracking_refstring nullable

Response

Accepted

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-21T14:46:47.665679Z",
  "updated_at": "2026-09-21T14:46:47.665715Z"
}

Changes