Skip to content

upstream-unavailable

Status 503
Title Upstream unavailable
Code upstream-unavailable
Type https://docs.satellitedata.net/problems/upstream-unavailable

Available now Lean v1 can return this problem.

A source the API depends on did not answer. The detail names it.

  • Earth Search, the catalog lean v1 runs on, is slow or down.
  • The renderer is switched off by the monthly spending stop.
  • In later phases, NASA Earthdata or Planetary Computer.

Retry after Retry-After seconds, with backoff. GET /v1/health shows which check is failing.

The detail is the example from the v1 contract.

{
"type": "https://docs.satellitedata.net/problems/upstream-unavailable",
"title": "Upstream unavailable",
"status": 503,
"detail": "NASA Earthdata returned 503 for the HLS credentials endpoint; HLS scenes are temporarily unavailable.",
"instance": "/v1/...",
"code": "upstream-unavailable",
"requestId": "01JQ7Z3M8R5V2W6X9Y0A1B2C3D"
}

See Errors for the members every problem carries.