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/replays/quote' \
  -H "Authorization: Bearer $LUMEUS_WEBHOOK_KEY" \
  -H 'If-Match: "1"' \
  -H 'Content-Type: application/json' \
  -d '{"generation":"testnet-2025-12-18-v2","delivery_ids":[1]}'

// 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/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",
    "delivery_ids": [
      1
    ]
  }),
});
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/replays/quote",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_WEBHOOK_KEY']}", "If-Match": "\"1\""},
    json={
        "generation": "testnet-2025-12-18-v2",
        "delivery_ids": [
            1
        ]
    },
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "subscription_id": "00000000-0000-4000-8000-000000000000",
  "subscription_version": 2,
  "generation": "testnet-2025-12-18-v2",
  "delivery_ids": [
    1
  ],
  "payload_sha256": [
    "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  ],
  "policy_version": "prepaid-2026-10",
  "target_sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
  "maximum_credits": 1,
  "resources": {
    "bytes": 4096,
    "attempts": 8,
    "work_ms": 0,
    "concurrency": 1,
    "retained_bytes": 0
  },
  "recoverable_until": "2026-10-23T09:15:04Z",
  "quote_sha256": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
}

Quote a redelivery

Prices a redelivery of past deliveries (by delivery ID) whose payloads are still retained. 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}

/

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/replays/quote' \
  -H "Authorization: Bearer $LUMEUS_WEBHOOK_KEY" \
  -H 'If-Match: "1"' \
  -H 'Content-Type: application/json' \
  -d '{"generation":"testnet-2025-12-18-v2","delivery_ids":[1]}'

// 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/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",
    "delivery_ids": [
      1
    ]
  }),
});
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/replays/quote",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_WEBHOOK_KEY']}", "If-Match": "\"1\""},
    json={
        "generation": "testnet-2025-12-18-v2",
        "delivery_ids": [
            1
        ]
    },
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "subscription_id": "00000000-0000-4000-8000-000000000000",
  "subscription_version": 2,
  "generation": "testnet-2025-12-18-v2",
  "delivery_ids": [
    1
  ],
  "payload_sha256": [
    "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  ],
  "policy_version": "prepaid-2026-10",
  "target_sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
  "maximum_credits": 1,
  "resources": {
    "bytes": 4096,
    "attempts": 8,
    "work_ms": 0,
    "concurrency": 1,
    "retained_bytes": 0
  },
  "recoverable_until": "2026-10-23T09:15:04Z",
  "quote_sha256": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
}

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

generation

string

required

delivery_ids

integer<int64>[]

required

Required array length: 1 - 128 elements

Required range: x >= 1

Response

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

subscription_id

string<uuid>

subscription_version

integer

generation

string

delivery_ids

integer[]

payload_sha256

string[]

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

policy_version

string

target_sha256

string

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

maximum_credits

integer

resources

object

Show child attributes

recoverable_until

string<date-time>

quote_sha256

string

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