1. Submit a file for transcription

Upload an audio or video file. Returns a job_id; poll the job status until completed or failed.

POST /api/v1/transcribe

Query: enable_diarization (optional, default true) — set to false for plain transcript only.

Response (202): {"job_id":"uuid","status":"pending","filename":"..."}

2. Get job status

Poll this until status is completed or failed. Then fetch the transcript (steps 3 or 4).

GET /api/v1/jobs/{job_id}

Response: {"job_id":"...","status":"pending|processing|completed|failed","message":"...","filename":"..."}

3. Get plain transcript

Returns the full text and segments (with timestamps). Use when job status is completed.

GET /api/v1/jobs/{job_id}/transcript

Response: {"job_id":"...","transcript":"...","segments":[{"text":"...","start_time":0,"end_time":1.5}],"language":"en-US","duration":120.5}

4. Get diarized transcript (speakers)

Same as plain transcript but each segment includes speaker (e.g. "Speaker 1"). Use when you enabled diarization.

GET /api/v1/jobs/{job_id}/diarized

Response: {"job_id":"...","transcript":"...","segments":[{"text":"...","speaker":"Speaker 1","start_time":0,"end_time":1.5}],"speaker_count":2,"language":"en-US","duration":120.5}

5. List jobs

Optional. List jobs for the organisation with optional status filter and pagination.

GET /api/v1/jobs?limit=10&offset=0&status=completed

Response: {"jobs":[...],"total":N}