cURL

# Use a subscription id from POST or GET /v1/subscriptions; the placeholder answers 404.
curl --fail-with-body -sS -X POST 'https://webhooks-testnet.lumeus.dev/v1/subscriptions/00000000-0000-4000-8000-000000000000/source-replays/quote' \
  -H "Authorization: Bearer $LUMEUS_WEBHOOK_KEY" \
  -H 'If-Match: "1"' \
  -H 'Content-Type: application/json' \
  -d '{"generation":"testnet-2025-12-18-v2","first_ledger":5331500,"last_ledger":5331520,"max_deliveries":10}'

// 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/source-replays/quote', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_WEBHOOK_KEY}`,
    'If-Match': '"1"',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "generation": "testnet-2025-12-18-v2",
    "first_ledger": 5331500,
    "last_ledger": 5331520,
    "max_deliveries": 10
  }),
});
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.post(
    "https://webhooks-testnet.lumeus.dev/v1/subscriptions/00000000-0000-4000-8000-000000000000/source-replays/quote",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_WEBHOOK_KEY']}", "If-Match": "\"1\""},
    json={
        "generation": "testnet-2025-12-18-v2",
        "first_ledger": 5331500,
        "last_ledger": 5331520,
        "max_deliveries": 10
    },
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "protocol": "lumeus-source-replay-quote-v1",
  "subscription_id": "00000000-0000-4000-8000-000000000000",
  "subscription_version": 2,
  "network": "testnet",
  "request": {
    "generation": "testnet-2025-12-18-v2",
    "first_ledger": 5331500,
    "last_ledger": 5331520,
    "max_deliveries": 10
  },
  "source_policy_version": "prepaid-2026-10",
  "delivery_policy_version": "prepaid-2026-10",
  "target_sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
  "maximum_credits": 12,
  "source_success_credits": 2,
  "source_bounds": {
    "response_bytes": 1048576,
    "timeout_ms": 10000,
    "max_events": 128,
    "max_payload_bytes": 65536
  },
  "source_max_attempts": 3,
  "resources": {
    "bytes": 4096,
    "attempts": 8,
    "work_ms": 0,
    "concurrency": 1,
    "retained_bytes": 0
  },
  "quote_sha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
}

Quote a source replay

Prices a replay of up to 64 consecutive ledgers read again from the RPC history. A quote reserves nothing; start the work with the returned quote_sha256. Use the endpoint’s current version (If-Match) and generation. Expired payloads and unsupported ranges are refused. Free Testnet endpoints answer 403 “free Testnet webhooks do not support replay”; paid plan endpoints answer 403 “replays are not yet available for paid webhook endpoints”.

POST

/

v1

/

subscriptions

/

{id}

/

source-replays

/

quote

cURL

# Use a subscription id from POST or GET /v1/subscriptions; the placeholder answers 404.
curl --fail-with-body -sS -X POST 'https://webhooks-testnet.lumeus.dev/v1/subscriptions/00000000-0000-4000-8000-000000000000/source-replays/quote' \
  -H "Authorization: Bearer $LUMEUS_WEBHOOK_KEY" \
  -H 'If-Match: "1"' \
  -H 'Content-Type: application/json' \
  -d '{"generation":"testnet-2025-12-18-v2","first_ledger":5331500,"last_ledger":5331520,"max_deliveries":10}'

// 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/source-replays/quote', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_WEBHOOK_KEY}`,
    'If-Match': '"1"',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "generation": "testnet-2025-12-18-v2",
    "first_ledger": 5331500,
    "last_ledger": 5331520,
    "max_deliveries": 10
  }),
});
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.post(
    "https://webhooks-testnet.lumeus.dev/v1/subscriptions/00000000-0000-4000-8000-000000000000/source-replays/quote",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_WEBHOOK_KEY']}", "If-Match": "\"1\""},
    json={
        "generation": "testnet-2025-12-18-v2",
        "first_ledger": 5331500,
        "last_ledger": 5331520,
        "max_deliveries": 10
    },
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "protocol": "lumeus-source-replay-quote-v1",
  "subscription_id": "00000000-0000-4000-8000-000000000000",
  "subscription_version": 2,
  "network": "testnet",
  "request": {
    "generation": "testnet-2025-12-18-v2",
    "first_ledger": 5331500,
    "last_ledger": 5331520,
    "max_deliveries": 10
  },
  "source_policy_version": "prepaid-2026-10",
  "delivery_policy_version": "prepaid-2026-10",
  "target_sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
  "maximum_credits": 12,
  "source_success_credits": 2,
  "source_bounds": {
    "response_bytes": 1048576,
    "timeout_ms": 10000,
    "max_events": 128,
    "max_payload_bytes": 65536
  },
  "source_max_attempts": 3,
  "resources": {
    "bytes": 4096,
    "attempts": 8,
    "work_ms": 0,
    "concurrency": 1,
    "retained_bytes": 0
  },
  "quote_sha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
}

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

Headers

If-Match

string

required

The ETag from GET /v1/subscriptions/{id}, for example "1" (the weak form W/"1" that some proxies produce is accepted too). A stale version returns 412; a missing header returns 428.

Pattern: ^(W/)?"[1-9][0-9]*"$

Example:

"\"1\""

Path Parameters

id

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"

Body

application/json

At most 64 consecutive inclusive ledgers and 128 deliveries, further bounded by the selected source policy.

generation

string

required

first_ledger

integer

required

Required range: x >= 3

last_ledger

integer

required

Inclusive end; must satisfy the selected bounded source policy.

max_deliveries

integer

required

Required range: 1 <= x <= 128

Response

The quote: maximum credits and the hash to start it with.

protocol

string

subscription_id

string<uuid>

subscription_version

integer

network

enum<string>

Available options:

mainnet,

testnet

request

object

At most 64 consecutive inclusive ledgers and 128 deliveries, further bounded by the selected source policy.

Show child attributes

source_policy_version

string

delivery_policy_version

string

target_sha256

string

Pattern: ^[0-9a-fA-F]{64}$

maximum_credits

integer

source_success_credits

integer

source_bounds

object

Show child attributes

source_max_attempts

integer

resources

object

Show child attributes

quote_sha256

string

Pattern: ^[0-9a-fA-F]{64}$