List loaded batches
The batches currently held in memory, with their sizes, hashes and creation times.
Last updated 12 September 2026
List loaded batches
GET https://api.quorumtech.ch/attest/v1/batches
Lists every batch the service currently holds. Batches expire six hours after they were created and are evicted oldest-first when the store is full, so a batch listed a moment ago may be gone by the time a check names it. The not-found error tells you to upload again.
batchHash identifies the set of documents as loaded, so a report can name which batch its verdicts were produced against.
Request
No body.
Example request
curl -X GET "https://api.quorumtech.ch/attest/v1/batches" \
-H "Authorization: Bearer $QUORUM_API_KEY"
Responses
200
The batches currently held in memory.
| Field | Type | Description |
| --- | --- | --- |
| batches | BatchSummary[] | |
| batches[].id | string | |
| batches[].name | string | May be null. |
| batches[].documents | integer | |
| batches[].spans | integer | |
| batches[].totalChars | integer | |
| batches[].createdAt | string (date-time) | |
| batches[].batchHash | string | |
Errors
The body is { "error": { "code", "message" } }; the full catalogue with what to do about each code is on the Errors page.
| Status | Codes | When |
| --- | --- | --- |
| 401 | | The key is missing, not recognised, or revoked. |
| 402 | payment_required, credits_exhausted, remaining, needed | The workspace has no active API subscription (payment_required), or is prepaid and has no credits left for this request (credits_exhausted, with remaining and needed). Manage billing and add credits at https://developer.quorumtech.ch/billing. |
| 403 | | The key is not scoped to Attest. |
| 429 | rate_limited, claims_rate_limited, claim_budget_exhausted, monthly_cap_reached, cap | Over the key's requests-per-minute limit (rate_limited), its claims-per-minute ceiling (claims_rate_limited), its claims-per-day budget (claim_budget_exhausted), or, for a postpaid workspace, its monthly credit cap (monthly_cap_reached, with cap and resetsAt). Retry-After says when to try again; the daily budget resets at midnight UTC and the cap on the first of the month. |
Cost
Free.
Related articles
Fetch a page in one call
The same work as the extract call, with the request held open until the page is done and the Markdown returned directly.
Watch an extraction
Server-sent events for one job: its state now, every change after it, and the finished page. Closes when the job does.
Read an extraction's progress
One frame of a job's state without its Markdown, for a progress bar that should not carry a page's text with every poll.
Collect an extraction
Poll a job that answered 202. Returns its state while it runs and the Markdown once it is done.
Still need help?
Ask Quincy in the chat bubble below, or write to support@quorumtech.ch and we will help you directly.