List transcribe jobs (for the authenticated user)

get/v1/transcribes

Request

  • Base URL: https://api.ffmpeg-micro.com
  • URL: https://api.ffmpeg-micro.com/v1/transcribes
  • Auth: HTTP bearer

Query parameters

status'pending' | 'processing' | 'completed' | 'failed' | 'canceled'

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.

pageinteger
limitinteger

Values outside 1-100 are clamped; non-numeric values return 400

order'created_at.desc' | 'updated_at.asc' | 'updated_at.desc'

Result ordering. Use updated_at.asc for cursor-based polling so the sort matches the since filter, or updated_at.desc for a newest-first view on the same cursor column. Unknown values return 400.

sincestring date-time

Return transcribes last updated at/after this timestamp (filters on updated_at). Invalid dates are rejected with 400.

untilstring date-time

Return transcribes last updated at/before this timestamp (filters on updated_at)

Response

OK

pageinteger
limitinteger
totalinteger

Example response

{
  "items": [
    {
      "id": "f8e6a1f4-2da3-496e-9e29-4d63502ad90c",
      "media_url": "gs://<YOUR_BUCKET>/narration.mp3",
      "output_url": "gs://ffmpeg-micro-user-<user-id>-output/<job-id>.srt",
      "queue_position": 3
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.