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/v1/jobs/:job_id

Authentication

Requires authentication using a Bearer token in the HTTP header:

Authorization: Bearer YOUR_API_KEY

Example Request

Using cURL

curl --request GET \
     --url https://api.speechischeap.com/v1/jobs/00000000-1111-4222-3333-444444444444-u1 \
     --header 'Authorization: Bearer YOUR_API_KEY'

Response

Status Codes

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

Status Code	Description
200 OK	Request successful
401 Unauthorized	Invalid or missing authentication token
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-4222-3333-444444444444-u1",
  "output": {},
  "status": "PENDING"
}

Completed Job Response

When the transcription is complete, you'll receive the full results:

{
  "id": "00000000-1111-4222-3333-444444444444-u1",
  "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"
}

Failed Job Response

{
  "id": "00000000-1111-4222-3333-444444444444-u1",
  "output": {
    "error": "Some error message"
  },
  "status": "COMPLETED"
}

Error Response

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

Error downloading the output

Job Status Values

Status	Description
PENDING	The job is still processing
COMPLETED	The job finished processing
CANCELED	The job was canceled
UNKNOWN	The job's status cannot be determined