Webhooks

List recent deliveries for a subscription

The delivery history for one subscription: what was sent, how it went, how many attempts it took, and what the endpoint answered.

This endpoint returns at most the 50 newest deliveries and there is no pager. It accepts no page, limit, or cursor parameter, and there is no way to reach anything older than those 50 rows through the API. A subscription that receives a high volume of events will roll past older history within minutes. If you need durable delivery records, capture them as they arrive rather than relying on reading them back here.

responseBody is truncated to the first 500 characters of whatever the endpoint returned, or holds the transport error when the request never got a response.

terminal is the field to branch on. It is true when the delivery has failed and no further automatic attempt is scheduled, which is exactly the state that POST /webhooks/{webhookId}/events/{eventId}/retry can reopen.

The subscription is resolved inside the workspace first, and its events are then read through both that subscription and the same workspace predicate, so nothing here can reach another tenant's deliveries.

get/webhooks/{webhookId}/events

Request

  • Base URL: https://inkseal.net/api/v1
  • URL: https://inkseal.net/api/v1/webhooks/{webhookId}/events
  • Auth: HTTP bearer

Response

Up to 50 deliveries, newest first. Not paginated: older history is unreachable.

Example response

{
  "data": [
    {
      "id": 4821,
      "eventType": "envelope.completed",
      "status": "failed",
      "attempts": 6,
      "responseStatus": 502,
      "responseBody": "<html><head><title>502 Bad Gateway</title></head>",
      "lastAttemptAt": "2026-08-21T06:12:44.771Z",
      "terminal": true,
      "createdAt": "2026-08-21T05:10:03.004Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.