Get Job Status and Output

This endpoint allows you to check the status of an existing transcription job and retrieve its results if available.

Endpoint

GET https://api.speechischeap.com/v2/jobs/:job_id

Query Parameters

Parameter	Type	Description
output_format	string	The desired format for the transcription output. Valid options are srt, vtt, or webvtt. If not provided, the output will be in JSON format.

Example Request

Using cURL

curl https://api.speechischeap.com/v2/jobs/00000000-1111-7222-b333-444444444444-sic

Response

The API uses standard HTTP status codes to indicate the outcome of your request:

Status Code	Description
200 OK	Request successful
404 Not Found	Job not found
500 Internal Server Error	Server-side error occurred

Pending Job Response

While the job is still being processed, you'll receive:

{
  "id": "00000000-1111-7222-b333-444444444444-sic",
  "output": {},
  "status": "PENDING"
}

Completed Job Response

When the transcription is complete, you'll receive the full results. The format depends on the output_format query parameter.

JSON Response (default)

{
  "id": "00000000-1111-7222-b333-444444444444-sic",
  "output": {
    "segments": [
      {
        "end": 12.345,
        "id": 1,
        "seek": 1234.5,
        "start": 1.234,
        "text": "This is an example of some transcribed text output.",
        "words": null
      }
    ]
  },
  "status": "COMPLETED"
}

SRT Response (output_format=srt)

The response will be in SRT format with a Content-Type: application/x-subrip header.

1
00:00:01,234 --> 00:00:12,345
This is an example of some transcribed text output.

2
00:00:13,000 --> 00:00:15,000
[music]

VTT Response (output_format=vtt)

The response will be in WebVTT format with a Content-Type: text/vtt header.

WEBVTT

1
00:00:01.234 --> 00:00:12.345
This is an example of some transcribed text output.

2
00:00:13.000 --> 00:00:15.000
[music]

Canceled Job Response

If the job was canceled:

{
  "id": "00000000-1111-7222-b333-444444444444-sic",
  "output": {},
  "status": "CANCELED"
}

Error Response

HTTP/1.1 500 Internal Server Error
Content-Type: text/plain

Internal Server Error