History coverage is incomplete (history_incomplete)

HTTP 409Orion /v3 ProblemCode: history_incomplete

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

The requested ledger range is not fully covered by the currently mounted archive and live buffer.

How to Resolve history_incomplete

1. Inspect the status (409), code (history_incomplete), 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/history_incomplete",
  "title": "History coverage is incomplete",
  "status": 409,
  "detail": "History coverage is incomplete",
  "code": "history_incomplete"
}

TypeScript / Fetch

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

cURL

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

---

← Back to All 53 Orion /v3 Problem Codes