Skip to content

Jobs

GET /jobs/{id}

Retrieve the details of job, specified by its id. Note that the user must have permissions to access or own the job itself for this to respond.

Parameters

  • id (required) - Identifier of the job to retrieve

Response

The details of the particular job will be in the response (specific to whether it was transcribe, translate or voicing), depending on whether the results are available. If the job finished with an error, an error message will be displayed along with an error ID in case it needs to be retried.

The following response is from a transcription request that is still processing:

{
  "id": "60ed56d11f580b4e33fe39c3",
  "ownerId": "c09d9c91-1d2a-4818-9713-b99b1d179f74",
  "provider": "SPEECHMATICS",
  "autoProvider": false,
  "service": "TRANSCRIBE",
  "status": "PROCESSING",
  "created": "2021-07-13T09:03:13.458+0000",
  "started": "2021-07-13T09:03:13.458+0000",
  "estimatedProgress": 15.621301,
  "url": "[masked]",
  "language": "en",
  "diarization": false,
  "sourceMetaData": {
    "fileSize": 2706213,
    "mimeType": "audio/mpeg",
    "mediaDuration": 169
  }
}

With the field estimatedProgress indicated as a percentage of how far the request has been processed.