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-27T01:00:32.317986Z",
  "updated_at": "2026-09-27T01:00:32.318023Z"
}

Changes

Changed in 3 of the 12 revisions of this API.22412

Sep 27, 2026955831a8d5e96See the full diff
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
Sep 21, 2026fd8c32a19c7f1248See the full diff
- ▲
  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 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/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/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/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/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/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_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 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
- ▲
  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 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
- ○
  request property list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  request property list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  added subschema #2 to the response property anyOf list for the response status
  response-property-any-of-added
Sep 10, 20262478839b1d3f44See 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 optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ○
  the request property became nullable
  request-property-became-nullable
- ○
  the request property became nullable
  request-property-became-nullable
- ○
  the request property became optional
  request-property-became-optional
- ○
  the request property became optional
  request-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