Skip to main content
GET
List all transcription jobs

Authorizations

Authorization
string
header
required

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

Query Parameters

limit
integer

Maximum number of transcription jobs to return

Required range: x <= 100
offset
integer

Number of transcription jobs to skip

status
enum<string>

Filter transcription jobs by status

Available options:
pending,
processing,
completed,
failed,
not_applicable
created_before
string<date>

Filter transcription jobs created before a specific date (YYYY-MM-DD format), in UTC timezone

created_after
string<date>

Filter transcription jobs created after a specific date (YYYY-MM-DD format), in UTC timezone

url
string

Filter transcription jobs by the input URL used for transcription

response_format
enum<string>

Format for the response

Available options:
json,
markdown
include_metadata
boolean
default:false

Include the file's user-defined metadata and source metadata. In markdown these render as a ## Metadata section; in JSON they populate file.metadata and file.source_metadata.

Response

A list of transcription jobs

object
enum<string>
required

Object type, always 'list'

Available options:
list
data
object[]
required

Array of transcription job objects

total
integer
required

Total number of transcription jobs matching the query

limit
integer
required

Number of items returned in this response