Service is temporarily unavailable (service_unavailable)

HTTP 503Orion /v3 ProblemCode: service_unavailable

Type URI: https://orion.stellarchain.io/problems/service_unavailable

The server or an upstream dependency is temporarily unavailable.

How to Resolve service_unavailable

1. Inspect the status (503), code (service_unavailable), and detail fields in the JSON response.
2. For 400 validation errors (invalid_*), verify query parameters against the Endpoints Reference or Statistics Catalog (GET /v3/statistics).
3. For 404 errors (*_not_found), confirm the resource exists on Stellar Pubnet.
4. For 409, 429, 503, or 504 transient states, retry with exponential backoff.

Example Response & Client Handling

application/problem+json

{
  "type": "https://orion.stellarchain.io/problems/service_unavailable",
  "title": "Service is temporarily unavailable",
  "status": 503,
  "detail": "Service is temporarily unavailable",
  "code": "service_unavailable"
}

TypeScript / Fetch

const res = await fetch('https://pubnet.stellarchain.io/v3/statistics');
if (!res.ok) {
  const problem = await res.json();
  if (problem.code === 'service_unavailable') {
    console.error('Orion /v3 Problem [service_unavailable]:', problem.detail);
  }
}

cURL

curl -i -s "https://pubnet.stellarchain.io/v3/statistics" \
  -H "Accept: application/json"

---

← Back to All 53 Orion /v3 Problem Codes