---
title: "List Industry Searches"
method: GET
path: "/api/v1/industry-searches"
tags: ["Industry Discovery"]
---

# List Industry Searches

`GET /api/v1/industry-searches`

The List Industry Searches endpoint retrieves a list of all industry discovery requests associated with the
account linked to the provided API key. Each entry in the list includes the unique identifier, creation and
update timestamps, current status, and a brief status description. If a search has been completed, the
result field will contain the discovered industry information; otherwise, it will be null.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- PagedBusinessSearch
  - `searches` BusinessSearch[], required
    - `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, required — The name of the business to search for.
      - `submitted_website` string, nullable — The website of the business to search for.
      - `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, required — The country where the business is located.
      - `external_tracking_ref` string
  - `count` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `prev_searches_link` PrevLink
    - `id` string, uuid, required
    - `type` 'io.truebiz.link.prev-items', required
    - `href` string, required
  - `next_searches_link` NextLink
    - `id` string, uuid, required
    - `type` 'io.truebiz.link.next-items', required
    - `href` string, required

## Other responses

- `202` — Accepted
- `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

---

[API](https://skmtc.net/truebiz/apis/truebiz-web-presence-review-api.md) · [All operations](https://skmtc.net/truebiz/apis/truebiz-web-presence-review-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truebiz/truebiz-web-presence-review-api/revisions/22a9a6d3740a/schema)