API ReferenceBatch Transcribe

Upload Batch Manifest File

Upload a batch manifest containing audio URLs for standard mode batch processing. **Workflow:** 1. Upload your manifest here to get a `batch_file_id` 2. Use that ID in [Create Batch Transcription](/api-reference/batch-transcribe/create-batch-transcription) with `processing_mode: "standard"` The manifest is a list of audio sources (max 500), each with a URL and optional title. You can provide it as a JSON array or JSONL format. If you need higher limits, contact support@sofer.ai.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.
content_typeenumRequired
Format of your manifest data
Allowed values:
json_itemslist of objectsOptional

For JSON format. Array of audio sources to transcribe (max 500). If you need higher limits, contact support@sofer.ai.

jsonlstringOptional

For JSONL format. One audio source per line as JSON, separated by newlines (max 500 lines). If you need higher limits, contact support@sofer.ai.

Example: {"audio_url": "https://..."}\n{"audio_url": "https://..."}

metadataobjectOptional
Optional title and description for this manifest

Response

This endpoint returns an object.
batch_file_idUUID

Use this ID when calling Create Batch Transcription with standard mode

item_countinteger
Number of audio sources in the manifest
size_bytesinteger
Size of the manifest in bytes
created_atdatetime
Upload timestamp
statusenum

Validation status. Wait for VALID before starting a batch.

Allowed values:
checksumstring
SHA256 checksum of the manifest
validation_errorslist of strings

If status is INVALID, lists what’s wrong with the manifest

Errors

401
Authentication Error
429
Rate Limit Error