---
title: "List search batches"
method: GET
path: "/searches/batches"
tags: ["Search"]
---

# List search batches

`GET /searches/batches`

List all search batches for the authenticated user's organization.

## Query parameters

- `q` string, nullable — Search query. Can be a batch ID (UUID) or batch name. If UUID, filters by exact ID match. Otherwise, filters by case-insensitive name match.
- `limit` integer — Maximum number of records to return in a single page. Must be between 1 and 1000.
- `offset` integer, nullable — Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor.
- `cursor` string, nullable — Opaque pagination cursor token that identifies the position in the result set. Use the cursor from the previous response to get the next page. Cannot be used with offset.
- `start_date` string, date, nullable — Filter records created on or after this date (format: YYYY-MM-DD).
- `end_date` string, date, nullable — Filter records created on or before this date (format: YYYY-MM-DD).
- `tz` string — IANA timezone identifier used to interpret start_date and end_date (defaults to UTC).

## Response `200`

List of search batches.

- V1BusinessSearchBatchResponse[]
  - `id` string, uuid, required — Unique identifier for the business search batch.
  - `name` string, required — The name of the business search batch.
  - `state` 'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
  - `progress` number, nullable — Processing progress from 0.0 to 1.0. Null if not yet started.
  - `completed_count` integer, nullable — Number of rows that have been processed. Null if not yet started.
  - `total_count` integer, nullable — Total number of rows to process. Null if not yet started.
  - `created_at` string, date-time, required — The datetime the business search batch was created.
  - `options` string[] — Optional features to enable during business search execution.
  - `warnings` string[] — Any warnings that occurred.
  - `export_csv_uri` string, nullable — GCS URI for the pre-computed CSV export. Available after batch completion.
  - `export_jsonl_uri` string, nullable — GCS URI for the pre-computed JSONL export. Available after batch completion.
  - `report_version` integer, nullable — Report schema version. Available after batch completion.
  - `questionnaire` DataTestQuestionnaire — Answers collected from the data-test Product Selection step. Persisted on the parent :class:`osiris.models.SearchBatch` row as a JSONB column for later analysis, and echoed to Slack for real-time ops visibility.
    - `kyb` DataTestKYBAnswers — Business Verification / KYB answers from the data-test questionnaire.
      - `current_provider` string, nullable
      - `new_applications_per_month` integer, nullable
      - `avg_uw_time_hours` integer, nullable
      - `avg_uw_time_minutes` integer, nullable
      - `match_rate_pct` number, nullable
      - `approval_rate_pct` number, nullable
    - `web_presence` DataTestWebPresenceAnswers — Web Presence Review answers from the data-test questionnaire. The list of sub-products the prospect opted into for Web Presence (Industry Prediction, Website Analysis, etc.) is deliberately not captured here — those selections are already represented by :class:`osiris.enums.BusinessSearchOptions` on the parent batch (``options`` on :class:`BusinessSearchBatchRequest`).
      - `existing_workflow_step` boolean, nullable
      - `current_provider` string, nullable
    - `liens` DataTestLiensAnswers — Liens Search answers from the data-test questionnaire.
      - `current_provider` string, nullable
    - `litigations` DataTestLitigationsAnswers — Litigations Search answers from the data-test questionnaire.
      - `current_provider` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/baselayer/apis/baselayer-api-service.md) · [All operations](https://skmtc.net/baselayer/apis/baselayer-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baselayer/baselayer-api-service/versions/0cc89938bc26/schema)