List claimable balances of an address

cURL

curl --fail-with-body -sS 'https://assets-testnet.lumeus.dev/accounts/GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA/claimable-balances?limit=10' \
  -H "Authorization: Bearer $LUMEUS_API_KEY"

// Node 18+ (ES module)
const res = await fetch('https://assets-testnet.lumeus.dev/accounts/GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA/claimable-balances?limit=10', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_API_KEY}`,
  },
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

import json
import os

import requests

res = requests.get(
    "https://assets-testnet.lumeus.dev/accounts/GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA/claimable-balances?limit=10",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_API_KEY']}"},
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "_embedded": {
    "records": [
      {
        "amount": "1100.0000000",
        "amount_raw": "11000000000",
        "asset": "TS100:GATQA24ZLMK6BT2N74NK762SZVIJATITTTV4TIEAUG2532PPUF3XTDDH",
        "asset_type": "credit_alphanum12",
        "balance_id": "000000005ecaedecc8203686fe427465b93aeda5e5f4513e7ca82f638221f014fc47c11c",
        "claimable_now": true,
        "claimants": [
          {
            "claimable_now": true,
            "destination": "GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA",
            "predicate": {
              "not": {
                "abs_before": "2026-10-22T15:05:00Z",
                "abs_before_epoch": "1792681500"
              }
            }
          },
          {
            "claimable_now": true,
            "destination": "GDGKJEL5Y2TDXGNLSL4LCOR6DULDXQLEFKCVHIYTRISU5BFWI3C2MUIT",
            "predicate": {
              "unconditional": true
            }
          }
        ],
        "decimals": 7,
        "flags": [
          "clawback_enabled"
        ],
        "last_modified_ledger": 5331563,
        "paging_token": "IjAwMDAwMDAwNWVjYWVkZWNjODIwMzY4NmZlNDI3NDY1YjkzYWVkYTVlNWY0NTEzZTdjYTgyZjYzODIyMWYwMTRmYzQ3YzExYyI",
        "sponsor": "GDGKJEL5Y2TDXGNLSL4LCOR6DULDXQLEFKCVHIYTRISU5BFWI3C2MUIT"
      },
      {
        "amount": "1250.0000000",
        "amount_raw": "12500000000",
        "asset": "TS100:GATQA24ZLMK6BT2N74NK762SZVIJATITTTV4TIEAUG2532PPUF3XTDDH",
        "asset_type": "credit_alphanum12",
        "balance_id": "00000000728f3385e5cdbb73dfe2580105bdd6de9746a09c1d39275768b9b87bb6710623",
        "claimable_now": true,
        "claimants": [
          {
            "claimable_now": true,
            "destination": "GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA",
            "predicate": {
              "not": {
                "abs_before": "2026-10-22T14:39:00Z",
                "abs_before_epoch": "1792679940"
              }
            }
          },
          {
            "claimable_now": true,
            "destination": "GBNLD5SMAHX2T5V6GGIF6SNM7CWLUX53YTIBLYXLC53AOX4G26FYE56V",
            "predicate": {
              "unconditional": true
            }
          }
        ],
        "decimals": 7,
        "flags": [
          "clawback_enabled"
        ],
        "last_modified_ledger": 5330563,
        "paging_token": "IjAwMDAwMDAwNzI4ZjMzODVlNWNkYmI3M2RmZTI1ODAxMDViZGQ2ZGU5NzQ2YTA5YzFkMzkyNzU3NjhiOWI4N2JiNjcxMDYyMyI",
        "sponsor": "GBNLD5SMAHX2T5V6GGIF6SNM7CWLUX53YTIBLYXLC53AOX4G26FYE56V"
      }
    ]
  },
  "_links": {
    "self": {
      "href": "/accounts/GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA/claimable-balances?limit=10"
    }
  },
  "address": "GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA",
  "limit": 10,
  "read_view": {
    "network": "testnet",
    "generation": "assets-testnet-v1-5253887",
    "as_of_ledger": 5332631,
    "as_of_closed_at": "2026-10-22T16:32:22Z",
    "bootstrap_ledger": 5253887
  },
  "role": "claimant"
}

GET

accounts

{address}

claimable-balances

cURL

curl --fail-with-body -sS 'https://assets-testnet.lumeus.dev/accounts/GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA/claimable-balances?limit=10' \
  -H "Authorization: Bearer $LUMEUS_API_KEY"

// Node 18+ (ES module)
const res = await fetch('https://assets-testnet.lumeus.dev/accounts/GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA/claimable-balances?limit=10', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_API_KEY}`,
  },
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

import json
import os

import requests

res = requests.get(
    "https://assets-testnet.lumeus.dev/accounts/GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA/claimable-balances?limit=10",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_API_KEY']}"},
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "_embedded": {
    "records": [
      {
        "amount": "1100.0000000",
        "amount_raw": "11000000000",
        "asset": "TS100:GATQA24ZLMK6BT2N74NK762SZVIJATITTTV4TIEAUG2532PPUF3XTDDH",
        "asset_type": "credit_alphanum12",
        "balance_id": "000000005ecaedecc8203686fe427465b93aeda5e5f4513e7ca82f638221f014fc47c11c",
        "claimable_now": true,
        "claimants": [
          {
            "claimable_now": true,
            "destination": "GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA",
            "predicate": {
              "not": {
                "abs_before": "2026-10-22T15:05:00Z",
                "abs_before_epoch": "1792681500"
              }
            }
          },
          {
            "claimable_now": true,
            "destination": "GDGKJEL5Y2TDXGNLSL4LCOR6DULDXQLEFKCVHIYTRISU5BFWI3C2MUIT",
            "predicate": {
              "unconditional": true
            }
          }
        ],
        "decimals": 7,
        "flags": [
          "clawback_enabled"
        ],
        "last_modified_ledger": 5331563,
        "paging_token": "IjAwMDAwMDAwNWVjYWVkZWNjODIwMzY4NmZlNDI3NDY1YjkzYWVkYTVlNWY0NTEzZTdjYTgyZjYzODIyMWYwMTRmYzQ3YzExYyI",
        "sponsor": "GDGKJEL5Y2TDXGNLSL4LCOR6DULDXQLEFKCVHIYTRISU5BFWI3C2MUIT"
      },
      {
        "amount": "1250.0000000",
        "amount_raw": "12500000000",
        "asset": "TS100:GATQA24ZLMK6BT2N74NK762SZVIJATITTTV4TIEAUG2532PPUF3XTDDH",
        "asset_type": "credit_alphanum12",
        "balance_id": "00000000728f3385e5cdbb73dfe2580105bdd6de9746a09c1d39275768b9b87bb6710623",
        "claimable_now": true,
        "claimants": [
          {
            "claimable_now": true,
            "destination": "GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA",
            "predicate": {
              "not": {
                "abs_before": "2026-10-22T14:39:00Z",
                "abs_before_epoch": "1792679940"
              }
            }
          },
          {
            "claimable_now": true,
            "destination": "GBNLD5SMAHX2T5V6GGIF6SNM7CWLUX53YTIBLYXLC53AOX4G26FYE56V",
            "predicate": {
              "unconditional": true
            }
          }
        ],
        "decimals": 7,
        "flags": [
          "clawback_enabled"
        ],
        "last_modified_ledger": 5330563,
        "paging_token": "IjAwMDAwMDAwNzI4ZjMzODVlNWNkYmI3M2RmZTI1ODAxMDViZGQ2ZGU5NzQ2YTA5YzFkMzkyNzU3NjhiOWI4N2JiNjcxMDYyMyI",
        "sponsor": "GBNLD5SMAHX2T5V6GGIF6SNM7CWLUX53YTIBLYXLC53AOX4G26FYE56V"
      }
    ]
  },
  "_links": {
    "self": {
      "href": "/accounts/GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA/claimable-balances?limit=10"
    }
  },
  "address": "GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA",
  "limit": 10,
  "read_view": {
    "network": "testnet",
    "generation": "assets-testnet-v1-5253887",
    "as_of_ledger": 5332631,
    "as_of_closed_at": "2026-10-22T16:32:22Z",
    "bootstrap_ledger": 5253887
  },
  "role": "claimant"
}

Authorizations

Authorization

string

header

required

Send Authorization: Bearer <key>, the same keys as Activity and RPC. Testnet: lum_test_…; Mainnet: lum_live_…. A key works only on its own network, so pick the server that matches it (the other network answers 401). Publishable lum_pub_… keys work only on the routes marked "Publishable keys allowed", from an allowed browser origin.

Path Parameters

address

string

required

Checksum-valid G or C address. An M… address resolves to its G account and the response carries muxed_input. B… and L… addresses are never holders.

Example:

"GCMIOIR346PXAPZB7J3SI4UCP5SAGSKNABB73K5FJPGIMYLMIV2UEHPA"

Query Parameters

role

enum<string>

default:claimant

claimant (default): balances the address can claim. sponsor: balances whose reserve the address sponsors.

Available options:

claimant,

sponsor

Example:

"claimant"

limit

integer

default:50

Records per page, 1 to 200 (default 50).

Required range: 1 <= x <= 200

Example:

10

cursor

string

Resume after this paging_token. Prefer following _links.next.href.

Response

A page of claimable balances.

read_view

object

required

Show child attributes

limit

integer

required

Effective page size: default 50, maximum 200.

_links

object

required

Show child attributes

_embedded

object

required

Show child attributes

address

string

required

The looked-up address (G or C; an M… input resolves to its G account).

role

enum<string>

required

Available options:

claimant,

sponsor

Activity API

Assets API

Webhooks

RPC

Account

List claimable balances of an address

Authorizations

Path Parameters

Query Parameters

Response