---
title: "Create Industry Search"
method: POST
path: "/api/v1/industry-searches"
tags: ["Industry Discovery"]
---

# Create Industry Search

`POST /api/v1/industry-searches`

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.

## Request body

- CreateSearchInput
  - `submitted_business_name` string, nullable — The name of the business to search for. **Required (along with an address) if you do not provide `submitted_website`.**
  - `submitted_website` string, nullable — The website of the business to search for. **Required unless you provide `submitted_business_name` together with an address.**
  - `city` string, nullable — The city where the business is located.
  - `state_province` string, nullable — The state or province where the business is located.
  - `postal_code` string, nullable — The postal code of the business location.
  - `country` string, 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_ref` string

## Response `202`

Accepted

- BusinessSearch
  - `id` string, uuid — The unique identifier of the industry search.
  - `external_tracking_ref` string
  - `created_at` string, date-time — The date and time when the industry search was created.
  - `updated_at` string, 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_description` string, required — A more detailed description of the current status.
  - `result` BusinessSearchResult
    - `business_name` string, required — The name of the business.
    - `business_description` string, required — A description of the business.
    - `business_address` string, nullable — The long-form address of the business.
    - `website` string, nullable — The website of the business.
    - `primary_mcc` MCC
      - `code` string, required — The Merchant Category Code.
      - `description` string, required — The description of the Merchant Category.
    - `additional_mccs` MCC[]
      - `code` string, required — The Merchant Category Code.
      - `description` string, required — The description of the Merchant Category.
  - `query` CreateSearchInput, required
    - `submitted_business_name` string, nullable — The name of the business to search for. **Required (along with an address) if you do not provide `submitted_website`.**
    - `submitted_website` string, nullable — The website of the business to search for. **Required unless you provide `submitted_business_name` together with an address.**
    - `city` string, nullable — The city where the business is located.
    - `state_province` string, nullable — The state or province where the business is located.
    - `postal_code` string, nullable — The postal code of the business location.
    - `country` string, 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_ref` string

## Other responses

- `204` — No Content
- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2026-09-10** `2478839b1d3f` — 4 breaking, 4 info
  - the response property `query/country` became nullable for the status `202`
  - the response property `query/submitted_business_name` became nullable for the status `202`
  - the response property `query/country` became optional for the status `202`
  - the response property `query/submitted_business_name` became optional for the status `202`
  - …4 more

[Change history](https://skmtc.dev/truebiz/apis/truebiz-web-presence-review-api/changes/api/v1/industry-searches/post.md)

---

[API](https://skmtc.dev/truebiz/apis/truebiz-web-presence-review-api.md) · [All operations](https://skmtc.dev/truebiz/apis/truebiz-web-presence-review-api/llms.txt) · [OpenAPI document](https://skmtc.dev/truebiz/apis/truebiz-web-presence-review-api/revisions/2478839b1d3f?raw)