API reference

upstream_unavailable — HTTP 502

The transcript service was unreachable. Safe to retry.

Example response

{
  "ok": false,
  "request_id": "req_...",
  "error": {
    "code": "upstream_unavailable",
    "message": "The transcript service was unreachable. Safe to retry."
  }
}

Why it happens

  • The transcript service behind the API was briefly unreachable.
  • The source platform temporarily blocked or timed out the fetch.

How to fix it

  • Retry with exponential backoff — these are transient by nature.
  • Check status at transcriptfetch.com/docs/status if failures persist.
Retryable? Yes — safe to retry; failed requests are never charged. Every error response carries a request_id — include it when contacting support.
Next →All error codes
upstream_unavailable (HTTP 502) · TranscriptFetch API error