Get coverage gaps

cURL

# Use a subscription id from POST or GET /v1/subscriptions; the placeholder answers 404.
curl --fail-with-body -sS 'https://webhooks-testnet.lumeus.dev/v1/subscriptions/00000000-0000-4000-8000-000000000000/coverage' \
  -H "Authorization: Bearer $LUMEUS_WEBHOOK_KEY"

// Node 18+ (ES module)
// Use a subscription id from POST or GET /v1/subscriptions; the placeholder answers 404.
const res = await fetch('https://webhooks-testnet.lumeus.dev/v1/subscriptions/00000000-0000-4000-8000-000000000000/coverage', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_WEBHOOK_KEY}`,
  },
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

# Use a subscription id from POST or GET /v1/subscriptions; the placeholder answers 404.
import json
import os

import requests

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

{
  "gaps": [
    {
      "first_ledger": 5293268,
      "last_ledger": 5293268,
      "reason": "free_quota_exhausted",
      "approximate": false
    },
    {
      "first_ledger": 5293270,
      "last_ledger": 5293270,
      "reason": "free_quota_exhausted",
      "approximate": false
    }
  ],
  "historical_until_ledger": 5293205,
  "subscription": {
    "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
  }
}

GET

subscriptions

{id}

coverage

cURL

# Use a subscription id from POST or GET /v1/subscriptions; the placeholder answers 404.
curl --fail-with-body -sS 'https://webhooks-testnet.lumeus.dev/v1/subscriptions/00000000-0000-4000-8000-000000000000/coverage' \
  -H "Authorization: Bearer $LUMEUS_WEBHOOK_KEY"

// Node 18+ (ES module)
// Use a subscription id from POST or GET /v1/subscriptions; the placeholder answers 404.
const res = await fetch('https://webhooks-testnet.lumeus.dev/v1/subscriptions/00000000-0000-4000-8000-000000000000/coverage', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_WEBHOOK_KEY}`,
  },
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

# Use a subscription id from POST or GET /v1/subscriptions; the placeholder answers 404.
import json
import os

import requests

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

{
  "gaps": [
    {
      "first_ledger": 5293268,
      "last_ledger": 5293268,
      "reason": "free_quota_exhausted",
      "approximate": false
    },
    {
      "first_ledger": 5293270,
      "last_ledger": 5293270,
      "reason": "free_quota_exhausted",
      "approximate": false
    }
  ],
  "historical_until_ledger": 5293205,
  "subscription": {
    "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
  }
}

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

Path Parameters

string<uuid>

required

Endpoint (subscription) ID from POST /v1/subscriptions or GET /v1/subscriptions. The example ID is a placeholder and answers 404: use your own.

Example:

"00000000-0000-4000-8000-000000000000"

Response

The endpoint and its coverage gaps.

subscription

object

required

Show child attributes

gaps

object[]

required

Show child attributes

historical_until_ledger

integer | null

required

Exclusive Activity boundary: activation checkpoint + 1. Null before activation.

Activity API

Assets API

Webhooks

RPC

Account

Get coverage gaps

Authorizations

Path Parameters

Response