List subscriptions

cURL

curl --fail-with-body -sS 'https://webhooks-testnet.lumeus.dev/v1/subscriptions?limit=50' \
  -H "Authorization: Bearer $LUMEUS_WEBHOOK_KEY"

// Node 18+ (ES module)
const res = await fetch('https://webhooks-testnet.lumeus.dev/v1/subscriptions?limit=50', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_WEBHOOK_KEY}`,
  },
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

import json
import os

import requests

res = requests.get(
    "https://webhooks-testnet.lumeus.dev/v1/subscriptions?limit=50",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_WEBHOOK_KEY']}"},
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "subscriptions": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "my-app",
      "target_url": "https://example.com/webhooks",
      "asset": "native",
      "event_types": [
        "transfer"
      ],
      "active": false,
      "created_at": "2026-10-20T09:46:50.582763Z",
      "admission_protocol": 2,
      "version": 2,
      "desired_state": "deleted",
      "effective_state": "deleted",
      "slot_state": "sponsored",
      "sponsored": true,
      "signing_version": 1,
      "generation": "testnet-2025-12-18-v2",
      "activation_checkpoint": 5293204,
      "effective_checkpoint": 5293284,
      "last_scanned_ledger": 5293284,
      "last_fully_admitted_ledger": 5293271,
      "metered": false
    },
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "my-app",
      "target_url": "https://example.com/webhooks",
      "asset": "native",
      "event_types": [
        "transfer"
      ],
      "active": false,
      "created_at": "2026-10-20T09:36:42.967981Z",
      "admission_protocol": 2,
      "version": 7,
      "desired_state": "deleted",
      "effective_state": "deleted",
      "slot_state": "sponsored",
      "sponsored": true,
      "signing_version": 1,
      "generation": "testnet-2025-12-18-v2",
      "activation_checkpoint": 5293082,
      "effective_checkpoint": 5293184,
      "last_scanned_ledger": 5293184,
      "last_fully_admitted_ledger": 5293184,
      "metered": false
    }
  ],
  "next_cursor": null
}

GET

subscriptions

cURL

curl --fail-with-body -sS 'https://webhooks-testnet.lumeus.dev/v1/subscriptions?limit=50' \
  -H "Authorization: Bearer $LUMEUS_WEBHOOK_KEY"

// Node 18+ (ES module)
const res = await fetch('https://webhooks-testnet.lumeus.dev/v1/subscriptions?limit=50', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_WEBHOOK_KEY}`,
  },
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

import json
import os

import requests

res = requests.get(
    "https://webhooks-testnet.lumeus.dev/v1/subscriptions?limit=50",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_WEBHOOK_KEY']}"},
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "subscriptions": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "my-app",
      "target_url": "https://example.com/webhooks",
      "asset": "native",
      "event_types": [
        "transfer"
      ],
      "active": false,
      "created_at": "2026-10-20T09:46:50.582763Z",
      "admission_protocol": 2,
      "version": 2,
      "desired_state": "deleted",
      "effective_state": "deleted",
      "slot_state": "sponsored",
      "sponsored": true,
      "signing_version": 1,
      "generation": "testnet-2025-12-18-v2",
      "activation_checkpoint": 5293204,
      "effective_checkpoint": 5293284,
      "last_scanned_ledger": 5293284,
      "last_fully_admitted_ledger": 5293271,
      "metered": false
    },
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "my-app",
      "target_url": "https://example.com/webhooks",
      "asset": "native",
      "event_types": [
        "transfer"
      ],
      "active": false,
      "created_at": "2026-10-20T09:36:42.967981Z",
      "admission_protocol": 2,
      "version": 7,
      "desired_state": "deleted",
      "effective_state": "deleted",
      "slot_state": "sponsored",
      "sponsored": true,
      "signing_version": 1,
      "generation": "testnet-2025-12-18-v2",
      "activation_checkpoint": 5293082,
      "effective_checkpoint": 5293184,
      "last_scanned_ledger": 5293184,
      "last_fully_admitted_ledger": 5293184,
      "metered": false
    }
  ],
  "next_cursor": null
}

Authorizations

Authorization

string

header

required

Send Authorization: Bearer whk_…, a webhook key from the dashboard. Webhook keys belong to one network, so pick the server that matches the key. lum_ API keys are not accepted here (401).

Query Parameters

limit

integer

default:500

Endpoints per page, 1 to 500 (default 500).

Required range: 1 <= x <= 500

Example:

50

cursor

string

next_cursor from the previous page.

include_deleted

boolean

Include deleted endpoints. Default false.

Example:

false

Response

A page of endpoints, newest first.

subscriptions

object[]

required

Show child attributes

next_cursor

string | null

required

Pass as cursor to get the next page; null on the last page.

Activity API

Assets API

Webhooks

RPC

Account

List subscriptions

Authorizations

Query Parameters

Response