Client identity header is invalid (invalid_client_identity)

HTTP 400Orion /v3 ProblemCode: invalid_client_identity

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

The client identity or forwarding header is malformed.

How to Resolve invalid_client_identity

1. Inspect the status (400), code (invalid_client_identity), 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/invalid_client_identity",
  "title": "Client identity header is invalid",
  "status": 400,
  "detail": "Client identity header is invalid",
  "code": "invalid_client_identity"
}

TypeScript / Fetch

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

cURL

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

---

← Back to All 53 Orion /v3 Problem Codes