Get Batch File | SoferAi

Get details about a specific batch file manifest, including its validation status. Check this after uploading to ensure your manifest is valid before starting a batch.

Authentication

AuthorizationBearer

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

Path parameters

batch_file_idUUIDRequired

The batch file ID returned from Upload Batch File

Response

This endpoint returns an object.

idUUID

Batch file ID

created_atdatetime

Upload timestamp

item_countinteger

Number of audio sources

size_bytesinteger

Manifest size in bytes

statusenum

Validation status

Allowed values:

checksumstring or null

SHA256 checksum

titlestring or null

Title from metadata

descriptionstring or null

Description from metadata

validation_errorslist of strings or null

If status is INVALID, lists what’s wrong

1	from soferai import SoferAI
2	from uuid import UUID
3
4	client = SoferAI(
5	api_key="YOUR_TOKEN_HERE"
6	)
7
8	client.batch_transcribe.get_batch_file(
9	batch_file_id=UUID("d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32")
10	)

1	{
2	"id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
3	"created_at": "2024-01-15T09:30:00Z",
4	"item_count": 25,
5	"size_bytes": 1048576,
6	"status": "PENDING_VALIDATION",
7	"checksum": "3a7bd3e2360a3f5b9c8d7e2f4a1b6c9d",
8	"title": "January Batch Upload",
9	"description": "Batch file manifest for January 2024 transcription jobs",
10	"validation_errors": [
11	"Row 12: Missing required field 'audio_url'",
12	"Row 45: Invalid timestamp format in 'start_time'"
13	]
14	}

Authentication

Path parameters

Response

Errors