cURL

curl --fail-with-body -sS 'https://assets-testnet.lumeus.dev/accounts/CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW/allowances?role=spender&limit=10' \
  -H "Authorization: Bearer $LUMEUS_API_KEY"

// Node 18+ (ES module)
const res = await fetch('https://assets-testnet.lumeus.dev/accounts/CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW/allowances?role=spender&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/CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW/allowances?role=spender&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": "1092193.0307809",
        "amount_raw": "10921930307809",
        "asset": "BLND:GATALTGTWIOT6BUDBCZM3Q4OQ4BO2COLOAZ7IYSKPLC2PMSOPPGF5V56",
        "asset_type": "credit_alphanum4",
        "contract_id": "CB22KRA3YZVCNCQI64JQ5WE7UY2VAV7WFLK6A2JN3HEX56T2EDAFO7QF",
        "decimals": 7,
        "expiration_ledger": 7345644,
        "expired": false,
        "last_modified_ledger": 5328585,
        "live_until_ledger": 7345644,
        "owner": "CBDVWXT433PRVTUNM56C3JREF3HIZHRBA64NB2C3B2UNCKIS65ZYCLZA",
        "paging_token": "WyJDQjIyS1JBM1laVkNOQ1FJNjRKUTVXRTdVWTJWQVY3V0ZMSzZBMkpOM0hFWDU2VDJFREFGTzdRRiIsIkNCRFZXWFQ0MzNQUlZUVU5NNTZDM0pSRUYzSElaSFJCQTY0TkIyQzNCMlVOQ0tJUzY1WllDTFpBIl0",
        "source": "ledger_entry",
        "spender": "CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW",
        "verified": true
      },
      {
        "amount": "17014118346046923173168730371588.4105727",
        "amount_raw": "170141183460469231731687303715884105727",
        "asset": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
        "asset_type": "credit_alphanum4",
        "contract_id": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
        "decimals": 7,
        "expiration_ledger": 6014398,
        "expired": false,
        "last_modified_ledger": 3014398,
        "live_until_ledger": 6014398,
        "owner": "CAUKLJ3QM4NNRDJ3J7AVKMIU7BBAK3RGKWIWSVGS7QL4D6CEZLEQGZS2",
        "paging_token": "WyJDQklFTFRLNllCWkpVNVVQMldXUUVVQ1lLTFBVNkFVTloyQlE0V1dGRUlFM1VTQ0lITVhRREFNQSIsIkNBVUtMSjNRTTROTlJESjNKN0FWS01JVTdCQkFLM1JHS1dJV1NWR1M3UUw0RDZDRVpMRVFHWlMyIl0",
        "source": "ledger_entry",
        "spender": "CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW",
        "verified": true
      }
    ]
  },
  "_links": {
    "self": {
      "href": "/accounts/CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW/allowances?role=spender&limit=10"
    }
  },
  "address": "CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW",
  "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": "spender"
}

List token allowances of an address

Live allowances the address granted (role=owner, default) or received (role=spender). Allowances are temporary entries: an absent or expired allowance is 0, and expired ones appear only with include=expired. Credit class assets-account: 1 × ceil(rows/100), at least one credit per started 64 KiB. Publishable keys allowed. The amount 17014118346046923173168730371588.4105727 (the i128 maximum at 7 decimals) means an unlimited approval.

Unknown or repeated query parameters return 400, so a typo or an unsupported filter never returns unfiltered data.

GET

accounts

{address}

allowances

cURL

curl --fail-with-body -sS 'https://assets-testnet.lumeus.dev/accounts/CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW/allowances?role=spender&limit=10' \
  -H "Authorization: Bearer $LUMEUS_API_KEY"

// Node 18+ (ES module)
const res = await fetch('https://assets-testnet.lumeus.dev/accounts/CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW/allowances?role=spender&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/CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW/allowances?role=spender&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": "1092193.0307809",
        "amount_raw": "10921930307809",
        "asset": "BLND:GATALTGTWIOT6BUDBCZM3Q4OQ4BO2COLOAZ7IYSKPLC2PMSOPPGF5V56",
        "asset_type": "credit_alphanum4",
        "contract_id": "CB22KRA3YZVCNCQI64JQ5WE7UY2VAV7WFLK6A2JN3HEX56T2EDAFO7QF",
        "decimals": 7,
        "expiration_ledger": 7345644,
        "expired": false,
        "last_modified_ledger": 5328585,
        "live_until_ledger": 7345644,
        "owner": "CBDVWXT433PRVTUNM56C3JREF3HIZHRBA64NB2C3B2UNCKIS65ZYCLZA",
        "paging_token": "WyJDQjIyS1JBM1laVkNOQ1FJNjRKUTVXRTdVWTJWQVY3V0ZMSzZBMkpOM0hFWDU2VDJFREFGTzdRRiIsIkNCRFZXWFQ0MzNQUlZUVU5NNTZDM0pSRUYzSElaSFJCQTY0TkIyQzNCMlVOQ0tJUzY1WllDTFpBIl0",
        "source": "ledger_entry",
        "spender": "CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW",
        "verified": true
      },
      {
        "amount": "17014118346046923173168730371588.4105727",
        "amount_raw": "170141183460469231731687303715884105727",
        "asset": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
        "asset_type": "credit_alphanum4",
        "contract_id": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
        "decimals": 7,
        "expiration_ledger": 6014398,
        "expired": false,
        "last_modified_ledger": 3014398,
        "live_until_ledger": 6014398,
        "owner": "CAUKLJ3QM4NNRDJ3J7AVKMIU7BBAK3RGKWIWSVGS7QL4D6CEZLEQGZS2",
        "paging_token": "WyJDQklFTFRLNllCWkpVNVVQMldXUUVVQ1lLTFBVNkFVTloyQlE0V1dGRUlFM1VTQ0lITVhRREFNQSIsIkNBVUtMSjNRTTROTlJESjNKN0FWS01JVTdCQkFLM1JHS1dJV1NWR1M3UUw0RDZDRVpMRVFHWlMyIl0",
        "source": "ledger_entry",
        "spender": "CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW",
        "verified": true
      }
    ]
  },
  "_links": {
    "self": {
      "href": "/accounts/CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW/allowances?role=spender&limit=10"
    }
  },
  "address": "CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW",
  "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": "spender"
}

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:

"CAPBMXIQTICKWFPWFDJWMAKBXBPJZUKLNONQH3MLPLLBKQ643CYN5PRW"

Query Parameters

role

enum<string>

default:owner

owner (default): allowances the address granted. spender: allowances it received.

Available options:

owner,

spender

Example:

"spender"

include

enum<string>

expired: also return expired allowances (amount 0).

Available options:

expired

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 allowances.

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:

owner,

spender

Activity API

Assets API

Webhooks

RPC

Account

List token allowances of an address

Authorizations

Path Parameters

Query Parameters

Response