For AI agents: a documentation index is available at /llms.txt. Markdown versions of all pages can be requested by appending `.md` to the URL, or by setting the `Accept` header to `text/markdown`.
Skip to main content
Transcription API

Get job details

GET https://eu1.asr.api.speechmatics.com/v2/jobs/{jobid}

Get job details, including progress and any error reports.

Authentication

  • bearerAuth Authorization: Bearer <token>

    Your API key, or a temporary key (JWT).

Path parameters

jobid
string

ID of the job.

Query parameters

wait
integer≥ 0
optional

If set, the request blocks for up to this many seconds, waiting for the job to reach a terminal state before responding. The value is capped by a server-side configured limit. The response is always the job in its current state (200): if the job reaches a terminal state within the wait it is returned terminal, otherwise it is returned in its current non-terminal state and the request can be retried to keep waiting.

Responses

OK

application/json application/vnd.speechmatics.v2+json
job
JobDetails

Document describing a job. JobConfig will be present in JobDetails returned for GET jobs/{id} request in SaaS and in Batch Appliance, but it will not be present in JobDetails returned as item in RetrieveJobsResponse in case of Batch Appliance.

import { BatchClient } from "@speechmatics/batch-client";

const client = new BatchClient({ apiKey: "YOUR_API_KEY", appId: "my-app" });

const { job } = await client.getJob("JOB_ID");
console.log(job.status);

Examples