List Batches For Manifest | SoferAi

Find batches created from a specific uploaded manifest, newest first. Only manifests and batches owned by the authenticated user are returned.

Use total_count to check whether this manifest has ever been used to create a batch. An unused manifest returns total_count: 0 and an empty batches list. A missing manifest or one owned by another user returns 404.

Each batch includes its current status and transcription counts. RECEIVED and PROCESSING indicate queued or active work; COMPLETED and FAILED indicate finished work. A completed batch can contain failed items. Use Get Batch Status with a returned batch_id for individual transcription details.

Results match the exact batch_file_id, not other uploads with identical contents. This is a read-only lookup, not an atomic duplicate-submission guard.

Find batches created from a specific uploaded manifest, newest first. Only manifests and batches owned by the authenticated user are returned. Use `total_count` to check whether this manifest has ever been used to create a batch. An unused manifest returns `total_count: 0` and an empty `batches` list. A missing manifest or one owned by another user returns 404. Each batch includes its current status and transcription counts. `RECEIVED` and `PROCESSING` indicate queued or active work; `COMPLETED` and `FAILED` indicate finished work. A completed batch can contain failed items. Use [Get Batch Status](/api-reference/batch-transcribe/get-batch-status) with a returned `batch_id` for individual transcription details. Results match the exact `batch_file_id`, not other uploads with identical contents. This is a read-only lookup, not an atomic duplicate-submission guard.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

batch_file_idUUIDRequired

The manifest ID returned by uploading a batch file or creating one from RSS.

Query parameters

limitintegerOptional

Number of batches per page. Defaults to 20; must be between 1 and 100.

offsetintegerOptional

Number of batches to skip. Defaults to 0; must be non-negative.

Response

This endpoint returns an object.

batch_file_idUUID

total_countinteger

Total matching batches across all pages. Zero means no batches have been created from this manifest.

batcheslist of objects

Matching batches ordered by creation time descending, then batch ID descending to break ties.

limitinteger

offsetinteger

has_moreboolean

next_offsetintegerOptional

Offset for the next page, omitted when there are no more results.

Errors

401

Authentication Error

404

Batch Not Found

429

Rate Limit Error

Find batches created from a specific uploaded manifest, newest first. Only manifests and batches owned by the authenticated user are returned.

Results match the exact batch_file_id, not other uploads with identical contents. This is a read-only lookup, not an atomic duplicate-submission guard.