Skip to content

List deliveries

Deliveries of an endpoint, newest first (without payloads).

GET
/v1/webhook-endpoints/{endpointId}/deliveries

Deliveries of an endpoint, newest first (without payloads).

Authorization

AuthorizationBearer <token>

OAuth 2.0 client credentials. private_key_jwt (SMART Backend Services asymmetric) is recommended; client secrets need an IP allowlist or mTLS outside the sandbox.

In: header

Scope: webhooks:read

Path Parameters

endpointId*string

An opaque we_ id.

Match^we_[0-9A-Za-z]{16,64}$

Query Parameters

cursor?string

Opaque cursor from nextCursor. Bound to the query's filters and valid for 24 hours.

Match^cur_[A-Za-z0-9_-]{8,2048}$
eventType?string
Lengthlength <= 60
limit?integer

Page size, 1 to 100 (default 25).

Range1 <= value <= 100
since?string

RFC 3339 timestamp with an explicit offset (Z or ±hh:mm). A timestamp without an offset is refused.

Match^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?(?:Z|[+-]\d{2}:\d{2})$
Formatdate-time
Lengthlength <= 40
status?string

Value in

  • "pending"
  • "waiting_circuit"
  • "delivering"
  • "succeeded"
  • "failed"
  • "expired"
  • "cancelled"

Header Parameters

Api-Version?enum

Overrides the app's pinned dated version for this request.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/webhook-endpoints/we_k57a1x2m9q4t8v3w5x1y6z7a8b9c0d1e/deliveries"
{  "data": [    {      "attemptCount": -9007199254740991,      "attempts": [        {          "durationMs": -9007199254740991,          "errorCode": "string",          "n": -9007199254740991,          "responseHeaders": [            {              "name": "string",              "value": "string"            }          ],          "responseSnippet": "string",          "responseStatus": -9007199254740991,          "signatureVersions": [            -9007199254740991          ],          "startedAt": "2026-09-14T15:00:11.402Z"        }      ],      "createdAt": "2026-09-14T15:00:11.402Z",      "endpointId": "we_k57a1x2m9q4t8v3w5x1y6z7a8b9c0d1e",      "eventExpiresAt": "2026-09-14T15:00:11.402Z",      "eventType": "string",      "id": "dlv_k57a1x2m9q4t8v3w5x1y6z7a8b9c0d1e",      "lastAttemptAt": "2026-09-14T15:00:11.402Z",      "lastErrorCode": "string",      "lastResponseStatus": -9007199254740991,      "messageId": "string",      "nextAttemptAt": "2026-09-14T15:00:11.402Z",      "object": "webhook_delivery",      "payload": {        "property1": null,        "property2": null      },      "status": "pending",      "succeededAt": "2026-09-14T15:00:11.402Z",      "trigger": "event"    }  ],  "hasMore": true,  "nextCursor": "string",  "object": "list"}

Was this page helpful?