Deliveries

A delivery is one attempt to send one event to one subscription. Endl records every one — the request sent, the response received, and each individual attempt. Every endpoint here requires the webhooks permission.

Mind the two similar paths: /api/v0/webhooks/events is the delivery log on this page, while /api/v0/events is the PULL event feed. The {id} in these paths is a delivery id, not an event id.

List deliveries

Your deliveries, newest first, with cursor pagination. Returns data.deliveries[], data.count, and data.nextCursor.

Query parameters

uuid

Scope results to one subscription.

enum

Filter by delivery status. Repeatable — ?status=FAILED&status=EXPIRED.

string

Filter by event type. Repeatable.

string

Pagination cursor.

integer

default:"25"

Page size, maximum 100.

curl -G https://qa-api.endl.xyz/api/v0/webhooks/events \
  -H "X-API-KEY: $ENDL_API_KEY" -H "X-API-SECRET: $ENDL_API_SECRET" \
  --data-urlencode "status=FAILED" --data-urlencode "limit=25"

{
  "code": 200,
  "message": "Success",
  "status": "SUCCESS",
  "data": {
    "deliveries": [
      {
        "id": "4d2f6a11-8c73-4b90-9e21-5f0a2c8d1e44",
        "eventId": "evt_9f1a4c7b2e08",
        "eventType": "payout.completed",
        "subscriptionId": "2b1e8f40-3c9a-4d21-9f7e-6a1c0b5d2e34",
        "status": "FAILED",
        "attemptCount": 5,
        "attemptBudget": 5,
        "lastStatusCode": 500,
        "lastErrorClass": "HTTP_5XX",
        "createdOn": "2026-09-02T12:34:56.789Z"
      }
    ],
    "count": 1,
    "nextCursor": "eyJ1IjoiREVMSVZFUklFUyJ9.a3f9c1e8d0"
  },
  "errors": []
}

Status codes

200 · 400 bad limit, bad cursor, bad parameter, or missing permission · 401 / 503 authentication

Get a delivery

The full record of one delivery, including what Endl sent, what your endpoint replied, and every attempt.

enum

Current delivery status.

integer

Attempts made against attempts allowed. A retry adds three.

integer | null

HTTP status of the most recent attempt.

enum / string

The most recent failure class and its message.

object | null

The payload Endl sent, parsed. Leaf values are strings.

string | null

The X-WEBHOOK-TIMESTAMP and X-WEBHOOK-SIGNATURE Endl sent.

any / boolean

Your endpoint’s reply, parsed if it was JSON, and whether it was truncated.

object[]

Each attempt, as {attemptNo, statusCode, errorClass, latencyMs, at}.

date-time | null

Lifecycle timestamps.

mixed

Identity and creation time. createdOn is the pagination sort key.

curl https://qa-api.endl.xyz/api/v0/webhooks/events/4d2f6a11-8c73-4b90-9e21-5f0a2c8d1e44 \
  -H "X-API-KEY: $ENDL_API_KEY" -H "X-API-SECRET: $ENDL_API_SECRET"

{
  "code": 200,
  "message": "Success",
  "status": "SUCCESS",
  "data": {
    "id": "4d2f6a11-8c73-4b90-9e21-5f0a2c8d1e44",
    "eventId": "evt_9f1a4c7b2e08",
    "eventType": "payout.completed",
    "subscriptionId": "2b1e8f40-3c9a-4d21-9f7e-6a1c0b5d2e34",
    "status": "FAILED",
    "attemptCount": 5,
    "attemptBudget": 5,
    "lastStatusCode": 500,
    "lastErrorClass": "HTTP_5XX",
    "lastError": "HTTP 500",
    "lastLatencyMs": 231,
    "requestTimestamp": "2026-09-02T12:34:56.789Z",
    "requestSignature": "a3f9c1e8b2…",
    "requestPayload": {
      "eventId": "evt_9f1a4c7b2e08",
      "eventType": "payout.completed",
      "eventCreatedAt": "2026-09-02T12:34:55.001Z",
      "version": "1.0",
      "data": {
        "referenceId": "c2608cc2-084b-41d1-8be2-c4f3abd55e5a",
        "referenceType": "TRANSACTION",
        "amount": "1500.00"
      }
    },
    "responseBody": "Internal Server Error",
    "responseTruncated": false,
    "attempts": [
      {
        "attemptNo": 1,
        "statusCode": 500,
        "errorClass": "HTTP_5XX",
        "latencyMs": 240,
        "at": "2026-09-02T12:35:00.000Z"
      }
    ],
    "expiresAt": "2026-09-03T12:34:56.789Z",
    "createdOn": "2026-09-02T12:34:56.789Z"
  },
  "errors": []
}

requestSignature and requestPayload are the fastest way to debug a signature mismatch: re-run your verifier against the exact timestamp and body Endl recorded here.

Status codes

200 · 404 not found or not yours · 400 non-UUID id or missing permission · 401 / 503 authentication

Retry a delivery

Re-arms one failed or expired delivery. Takes no body. It grants three more attempts and a fresh delivery window, and the status returns to QUEUED.

Retryable states only. Retrying a DELIVERED delivery returns 409, because it would double-deliver, and so does one still in flight. Only FAILED and EXPIRED can be retried.

curl -X POST https://qa-api.endl.xyz/api/v0/webhooks/events/4d2f6a11-8c73-4b90-9e21-5f0a2c8d1e44/retry \
  -H "X-API-KEY: $ENDL_API_KEY" -H "X-API-SECRET: $ENDL_API_SECRET"

{
  "code": 200,
  "message": "Delivery re-armed",
  "status": "SUCCESS",
  "data": {
    "id": "4d2f6a11-8c73-4b90-9e21-5f0a2c8d1e44",
    "eventId": "evt_9f1a4c7b2e08",
    "eventType": "payout.completed",
    "subscriptionId": "2b1e8f40-3c9a-4d21-9f7e-6a1c0b5d2e34",
    "status": "QUEUED",
    "attemptCount": 5,
    "attemptBudget": 8,
    "nextAttemptAt": "2026-09-02T13:00:00.000Z",
    "expiresAt": "2026-09-03T13:00:00.000Z",
    "createdOn": "2026-09-02T12:34:56.789Z"
  },
  "errors": []
}

Notice attemptBudget rising from 5 to 8 while attemptCount stays at 5 — that is the three extra attempts a retry grants.

Status codes

200 re-armed · 400 retry rate limit, non-UUID id, or missing permission · 404 not found · 409 already delivered or otherwise not retryable · 401 / 503 authentication

Get started

Endpoints

Conventions

List deliveries

Query parameters

Get a delivery

Retry a delivery

​List deliveries

​Query parameters

​Get a delivery

​Retry a delivery

List deliveries

Query parameters

Get a delivery

Retry a delivery