Skip to content

Claimable balance ID is invalid (invalid_claimable_balance) ​

HTTP 400Orion /v3 ProblemCode: invalid_claimable_balance
Type URI: https://orion.stellarchain.io/problems/invalid_claimable_balance

The claimable balance ID must be a valid 72-character hex balance ID (`00000000...`).

How to Resolve invalid_claimable_balance

  1. Inspect the status (400), code (invalid_claimable_balance), 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 ​

json
{
  "type": "https://orion.stellarchain.io/problems/invalid_claimable_balance",
  "title": "Claimable balance ID is invalid",
  "status": 400,
  "detail": "Claimable balance ID is invalid",
  "code": "invalid_claimable_balance"
}
typescript
const res = await fetch('https://pubnet.stellarchain.io/v3/statistics');
if (!res.ok) {
  const problem = await res.json();
  if (problem.code === 'invalid_claimable_balance') {
    console.error('Orion /v3 Problem [invalid_claimable_balance]:', problem.detail);
  }
}
bash
curl -i -s "https://pubnet.stellarchain.io/v3/statistics" \
  -H "Accept: application/json"

← Back to All 53 Orion /v3 Problem Codes

Open-Source Stellar Horizon & Orion Documentation under MIT License.