---
title: "Post Consortium Search Batch"
method: POST
path: "/consortium/searches/batches"
tags: ["Consortium"]
---

# Post Consortium Search Batch

`POST /consortium/searches/batches`

Submit a CSV of consortium searches (one search per row, one of each identifier). Always processed asynchronously (202 + batch id); poll GET /consortium/searches/batches/{batch_id} and download per-row results via /consortium/searches/batches/{batch_id}/download. Batches are capped at 40,000 rows. Allowed columns: reference_id, ein, phone, email, website, business_name, officer_first_name, officer_last_name, officer_state, address_street, address_city, address_state, address_zip, business_id.

## Response `202`

Successful Response

- V1ConsortiumCheckBatchResponse — Returned when a batch is accepted and by the polling endpoint.
  - `id` string, uuid, required — The batch's id, used to poll status and fetch results.
  - `state` 'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
  - `progress` number, nullable — Fraction of entries processed so far, in [0, 1].
  - `completed_count` integer, nullable — Number of entries processed so far.
  - `total_count` integer, nullable — Total number of entries in the batch.
  - `created_at` string, date-time, required — When the batch was accepted.

## 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/revisions/0cc89938bc26/schema)