Error reference

upstream_degraded

Every upstream source for the request failed or was blocked.

HTTP 503upstream_unavailableRetryable0 credits

HTTP 503error.type = upstream_unavailable

How to fix it

Branch on error.type and error.code; see the error catalog and the response-envelope docs.

Example response

503 upstream_unavailable

// HTTP 503
{
  "error": {
    "type": "upstream_unavailable",
    "code": "upstream_degraded",
    "message": "Every upstream source for the request failed or was blocked.",
    "param": null,
    "requestId": "req_…",
    "creditsCharged": 0,
    "retryable": true,
    "docUrl": "https://stayingapi.com/docs/errors/upstream_degraded"
  }
}

This error is free

Like every StayingAPI error, upstream_degraded returns creditsCharged: 0. You are never billed for a failed, empty, blocked or not-found call.

See the full error catalog or the response envelope. The canonical URL for this page is https://stayingapi.com/docs/errors/upstream_degraded.