Skip to main content
GET
/
status
/
batch
/
{batch_id}
Get batch status
curl --request GET \
  --url https://api.soket.ai/transcribe/status/batch/{batch_id} \
  --header 'Authorization: Bearer <token>'
{
  "batch_id": "<string>",
  "total_files": 123,
  "files_completed": 123,
  "files_failed": 123,
  "estimated_audio_seconds": 123,
  "estimated_completion_seconds": 123,
  "status": "<string>",
  "total_jobs": 123,
  "completed_jobs": 123,
  "failed_jobs": 123,
  "processing_jobs": 123,
  "queued_jobs": 123,
  "files_processing": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.tensorstudio.ai/llms.txt

Use this file to discover all available pages before exploring further.

Returns aggregate progress for all files and chunk jobs in a batch.

Typical response (production)

{
  "batch_id": "0f8fad5b-d9cb-469f-a165-70867728950e",
  "total_files": 4,
  "files_completed": 2,
  "files_failed": 0,
  "estimated_audio_seconds": 290.0,
  "estimated_completion_seconds": 21.7,
  "status": "processing"
}
In development mode, additional counters can be present: total_jobs, completed_jobs, failed_jobs, processing_jobs, queued_jobs, and files_processing.

Example

curl -X GET "https://api.soket.ai/transcribe/status/batch/$BATCH_ID" \
  -H "Authorization: Bearer $JWT_TOKEN"

Authorizations

Authorization
string
header
required

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

Path Parameters

batch_id
string
required

Response

Batch status response

batch_id
string
total_files
integer
files_completed
integer
files_failed
integer
estimated_audio_seconds
number
estimated_completion_seconds
number
status
string
total_jobs
integer
completed_jobs
integer
failed_jobs
integer
processing_jobs
integer
queued_jobs
integer
files_processing
integer