Skip to main content

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"
}
FieldDescription
statusoperational, degraded, or down.
messageA short reason. It is OK when the status is operational.
checkedAtThe time of the check, as an ISO 8601 timestamp in UTC.
StatusMeaning
operationalTranscription is running normally.
degradedJobs are queuing longer than usual or failing more often than usual. Jobs can take longer to finish.
downThe 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 CodeDescription
200 OKThe key is valid. The body is Authenticated.
401 UnauthorizedThe Authorization header is missing or malformed, or the key is unknown, expired, or revoked.
402 Payment RequiredThe 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.