API Health
Check whether the Jobs API, its transcription service, and the upload host are working, and whether an API key is valid. The three health checks need no API key.
Jobs API Health
GET https://api.speechischeap.com/v2/jobs/health
Response
HTTP/1.1 200 OK
Content-Type: text/plain
Healthy
Transcription Health
GET https://api.speechischeap.com/v2/jobs/health/inference
This request reports whether transcription is running normally.
Response
The response is always 200 OK, including when transcription is slow or unavailable, so read status instead of the HTTP status. The API doesn't cache the response.
{
"checkedAt": "2026-10-25T21:57:32.093Z",
"message": "OK",
"status": "operational"
}
| Field | Description |
|---|---|
status | operational, degraded, or down. |
message | A short reason. It is OK when the status is operational. |
checkedAt | The time of the check, as an ISO 8601 timestamp in UTC. |
| Status | Meaning |
|---|---|
operational | Transcription is running normally. |
degraded | Jobs are queuing longer than usual or failing more often than usual. Jobs can take longer to finish. |
down | The check couldn't reach the transcription service. |
Upload Health
GET https://upload.speechischeap.com/health
Response
{
"status": "ok",
"disk": {
"used_gb": "26.83",
"available_gb": "10.40",
"usage_percent": "71.0"
}
}
status is ok when the upload host answers. The disk object reports storage use on the host, as strings. Use status as the health signal.
Check an API Key
GET https://api.speechischeap.com/v2/jobs/auth
Send your API key as a Bearer token to check it before you start work:
curl https://api.speechischeap.com/v2/jobs/auth \
--header 'Authorization: Bearer YOUR_API_KEY'
Response
| Status Code | Description |
|---|---|
| 200 OK | The key is valid. The body is Authenticated. |
| 401 Unauthorized | The Authorization header is missing or malformed, or the key is unknown, expired, or revoked. |
| 402 Payment Required | The key is known, but its billing isn't active. |
Errors
The key check returns the same 401 and 402 messages as every request that takes an API key. See Jobs API errors.