List a webhook's deliveries

THE CALL, PART BY PART

method

GET

host

strait.link

version

/v1

resource

/webhooks/{id}/deliveries

GET /v1/webhooks/{id}/deliveries

Auth: secret key as Authorization: Bearer. Server-side only.

Request

Delivery history, newest first: every event sent to this webhook with its status (pending = waiting for a retry, delivered, failed = gave up after 6 attempts), attempts, the last HTTP status or error, and when the next retry is due. Payloads are not returned. History is kept 30 days.

Parameters

id required string path
The webhook id
limit integer query
1–100, default 20
cursor string query
nextCursor from the previous page
status "pending" | "delivered" | "failed" query
Only deliveries in this state; failed is the dead-letter list
event string query
Only this event, e.g. app.opened

Response

  • 200 A page of deliveries
  • 400 Bad limit or cursor
  • 401 Missing or invalid secret key
  • 404 No such webhook in the key's workspace
Request · curl
curl -X GET https://strait.link/v1/webhooks/<webhook id>/deliveries \
  -H "Authorization: Bearer $SECRET_KEY"

The response, printed

Response 200
{
  "deliveries": [
    {
      "id": "3c9e1a7b-5d2f-4e8a-b6c1-9f0d2e4a7b58",
      "webhookId": "7f3e2c1a-9b4d-4e8f-a6c5-2d1b0e9f8a73",
      "event": "link.clicked",
      "status": "failed",
      "attempts": 6,
      "lastStatus": 500,
      "lastError": "HTTP 500",
      "nextAttemptAt": null,
      "createdAt": "2026-10-01T10:00:00.000Z",
      "deliveredAt": null
    }
  ],
  "nextCursor": null
}