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

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:

{
  "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"
}

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