---
title: "Get Consortium Search Batch"
method: GET
path: "/consortium/searches/batches/{batch_id}"
tags: ["Consortium"]
---

# Get Consortium Search Batch

`GET /consortium/searches/batches/{batch_id}`

## Path parameters

- `batch_id` string, uuid, required

## Response `200`

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.dev/baselayer/apis/baselayer-api-service.md) · [All operations](https://skmtc.dev/baselayer/apis/baselayer-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/baselayer/baselayer-api-service/revisions/0cc89938bc26/schema)