List transcodes (for the authenticated user)
Request
- Base URL: https://api.ffmpeg-micro.com
- URL: https://api.ffmpeg-micro.com/v1/transcodes
- Auth: HTTP bearer
Query parameters
Job lifecycle: pending (created, awaiting pickup) → processing → completed | failed; a user cancellation sets canceled (US spelling). Note there is no queued status — new jobs start as pending.
Filter by status. The value is not validated against the enum — an unknown value returns an empty result set, not an error.
Values outside 1-100 are clamped; non-numeric values return 400
Result ordering. Use updated_at.asc for cursor-based polling so the sort matches the since filter (both key on updated_at); paging forward with the default created_at.desc skips backlog items. Use updated_at.desc for a newest-first view on the same cursor column (for example, choosing where a poller starts). Unknown values return 400.
Restrict to one job type. Without it this endpoint returns BOTH transcode and transcribe jobs (they share the resource shape).
Return transcodes last updated at/after this timestamp (filters on updated_at, not created_at — a job created earlier but completed inside the window is included). Invalid dates are rejected with 400.
Return transcodes last updated at/before this timestamp (filters on updated_at)
Response
OK (total count is in the body total field)
Example response
{
"items": [
{
"id": "b5f5a9c0-9e33-4e77-8a5b-6a0c2cd9c0b3",
"billable_minutes": 2.25,
"duration_seconds": 135,
"queue_position": 3,
"ffmpeg_options": {
"options": [
{
"option": "-c:v"
}
]
}
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.