---
title: "Get Bulk Intake Status"
method: GET
path: "/v1/intake/bulk/{batch_id}"
tags: ["intake"]
---

# Get Bulk Intake Status

`GET /v1/intake/bulk/{batch_id}`

## Request

- Base URL: `https://api.claims.zicron.ai`
- URL: `https://api.claims.zicron.ai/v1/intake/bulk/{batch_id}`
- Auth: none declared

Poll the status of a bulk intake batch.

Complements the ``bulk_intake.completed`` webhook (and is the fallback
when no ``webhook_url`` was provided): partners can poll the ``batch_id``
returned by ``POST /intake/bulk`` until ``status`` is terminal.

Item shape matches the webhook's ``items`` array exactly, so partners can
share one parser for both paths.

Returns 404 for unknown batch IDs and for batches submitted with
``async_scoring=false`` (no background work exists to poll — the sync
response was already final).

## Path parameters

- `batch_id` string, required

## Response `200`

Successful Response

- ExtractionApiRoutesIntakeBatchStatusResponse
  - `batch_id` string, required
  - `status` string, required: processing | completed | partial
  - `total` integer, required
  - `completed` integer, required
  - `failed` integer, required
  - `pending` integer, required
  - `source` string, nullable
  - `webhook_sent` boolean
  - `items` BatchStatusItem[], required
    - `claim_id` string, nullable
    - `external_id` string, nullable
    - `status` string, required
    - `overall_score` number, nullable: Case strength score, 0.0-1.0 (not a percentage). Deterministic rating of how well the evidence supports each evaluation step. Use it to rank and triage; it is NOT a probability of approval and has not been calibrated against claim outcomes.
    - `confidence` string, nullable: low | medium | high
    - `error` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zicron/apis/zicron-api.md) · [All operations](https://skmtc.dev/zicron/apis/zicron-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zicron/apis/zicron-api/revisions/abe62e22aa46?raw)
