Get a snapshot job - Lumeus

cURL

# Use the id returned by POST /snapshots; the placeholder answers 404.
curl --fail-with-body -sS 'https://assets-testnet.lumeus.dev/snapshots/00000000-0000-4000-8000-000000000000' \
  -H "Authorization: Bearer $LUMEUS_API_KEY"

// Node 18+ (ES module)
// Use the id returned by POST /snapshots; the placeholder answers 404.
const res = await fetch('https://assets-testnet.lumeus.dev/snapshots/00000000-0000-4000-8000-000000000000', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_API_KEY}`,
  },
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

# Use the id returned by POST /snapshots; the placeholder answers 404.
import json
import os

import requests

res = requests.get(
    "https://assets-testnet.lumeus.dev/snapshots/00000000-0000-4000-8000-000000000000",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_API_KEY']}"},
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "id": "00000000-0000-4000-8000-000000000000",
  "kind": "holdings",
  "params": {
    "kind": "holdings",
    "address": "GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR",
    "as_of_ledger": 5300000
  },
  "status": "completed",
  "created_at": "2026-10-22T09:15:04Z",
  "finished_at": "2026-10-22T09:15:31Z",
  "result": {
    "source": "history",
    "kind": "holdings",
    "address": "GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR",
    "as_of_ledger": 5300000,
    "checkpoint": 0,
    "ledgers_replayed": 0,
    "records": [
      {
        "asset": "native",
        "kind": "native",
        "source": "ledger_entry",
        "balance": "7542806429.6530056",
        "balance_raw": "75428064296530056",
        "decimals": 7,
        "archived": false,
        "last_modified_ledger": 5299980
      }
    ],
    "zero_balances": 0,
    "truncated": false,
    "entries_scanned": 3,
    "timings": {
      "bootstrap_ms": 0,
      "replay_ms": 0,
      "total_ms": 41
    }
  }
}

GET

/

snapshots

/

{id}

cURL

# Use the id returned by POST /snapshots; the placeholder answers 404.
curl --fail-with-body -sS 'https://assets-testnet.lumeus.dev/snapshots/00000000-0000-4000-8000-000000000000' \
  -H "Authorization: Bearer $LUMEUS_API_KEY"

// Node 18+ (ES module)
// Use the id returned by POST /snapshots; the placeholder answers 404.
const res = await fetch('https://assets-testnet.lumeus.dev/snapshots/00000000-0000-4000-8000-000000000000', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_API_KEY}`,
  },
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

# Use the id returned by POST /snapshots; the placeholder answers 404.
import json
import os

import requests

res = requests.get(
    "https://assets-testnet.lumeus.dev/snapshots/00000000-0000-4000-8000-000000000000",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_API_KEY']}"},
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "id": "00000000-0000-4000-8000-000000000000",
  "kind": "holdings",
  "params": {
    "kind": "holdings",
    "address": "GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR",
    "as_of_ledger": 5300000
  },
  "status": "completed",
  "created_at": "2026-10-22T09:15:04Z",
  "finished_at": "2026-10-22T09:15:31Z",
  "result": {
    "source": "history",
    "kind": "holdings",
    "address": "GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR",
    "as_of_ledger": 5300000,
    "checkpoint": 0,
    "ledgers_replayed": 0,
    "records": [
      {
        "asset": "native",
        "kind": "native",
        "source": "ledger_entry",
        "balance": "7542806429.6530056",
        "balance_raw": "75428064296530056",
        "decimals": 7,
        "archived": false,
        "last_modified_ledger": 5299980
      }
    ],
    "zero_balances": 0,
    "truncated": false,
    "entries_scanned": 3,
    "timings": {
      "bootstrap_ms": 0,
      "replay_ms": 0,
      "total_ms": 41
    }
  }
}

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

id

string<uuid>

required

The id returned by POST /snapshots (also in its Location header). The example ID is a placeholder and answers 404.

Example:

"00000000-0000-4000-8000-000000000000"

Response

The job; result is present once status is completed.

id

string<uuid>

required

kind

enum<string>

required

Available options:

holdings,

holders

params

object

required

Show child attributes

status

enum<string>

required

Available options:

queued,

running,

completed,

failed

created_at

string<date-time>

required

muxed_input

string

The M… address from the request, when one was sent.

result

object

A flat list of balances at as_of_ledger. Unlike the live routes it has no read_view, _links or paging.

Show child attributes

error

string

Why the job failed.

finished_at

string<date-time>