Skip to main content
GET
/
results
/
batch
/
{batch_id}
Get batch results
curl --request GET \
  --url https://api.soket.ai/transcribe/results/batch/{batch_id} \
  --header 'Authorization: Bearer <token>'
{
  "batch_id": "<string>",
  "page": 123,
  "limit": 123,
  "total_pages": 123,
  "total_files": 123,
  "count": 123,
  "files": [
    {}
  ]
}

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.

Paginated batch results endpoint.

​
Query params

  • status (optional): completed, failed, retrying, processing
  • page (default: 1)
  • limit (default: 50, max: 200)
  • raw (default: false)
    • false: merged per-file results
    • true: raw per-job records
  • chunks (optional bool): include chunk-level details inline
  • speech_information (optional bool): include segment-level speech information (tone, accent, speaker_id, timestamps, etc.)

​
Example (merged, completed only)

curl -X GET "https://api.soket.ai/transcribe/results/batch/$BATCH_ID?status=completed&page=1&limit=100" \
  -H "Authorization: Bearer $JWT_TOKEN"

​
Example (raw job records)

curl -X GET "https://api.soket.ai/transcribe/results/batch/$BATCH_ID?raw=true&page=1&limit=100" \
  -H "Authorization: Bearer $JWT_TOKEN"

​
Typical response shapes

  • raw=false: { batch_id, page, limit, total_pages, total_files, count, files: [...] }
  • raw=true: { batch_id, page, limit, total_pages, total_jobs, count, jobs: [...] }
  • Missing batch with no status filter: { "error": "batch not found" }

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

Query Parameters

​
status
enum<string>
Available options:
completed,
failed,
retrying,
processing
​
page
integer
default:1
Required range: x >= 1
​
limit
integer
default:50
Required range: 1 <= x <= 200
​
raw
boolean
default:false
​
chunks
boolean
​
speech_information
boolean

Include segment-level speech information (tone, accent, speaker_id, timestamps, etc.)

Response

Batch results response

​
batch_id
string
​
page
integer
​
limit
integer
​
total_pages
integer
​
total_files
integer
​
count
integer
​
files
object[]