API referenceWebhooks

List webhook deliveries

Lists every delivery attempt of the endpoint from the last 30 days, newest first, with status code, latency, a truncated response body and the error.

GET
/v1/webhooks/{endpointId}/deliveries
bearerAuth
headerAuthorizationBearer <token>

An organization API key (koast_sk_…) with the API surface enabled, or an OAuth access token issued by Koast (koast_at_…) whose audience covers this API. REST access requires an active Agency plan.

endpointId*string

The webhook endpoint id (ep_…).

Length1 <= length <= 64
cursor?string

Opaque cursor from the previous page's nextCursor. Omit for the first page.

limit?integer

Page size.

Range1 <= value <= 100
Default50

Response Body

List webhook deliveries

application/json
  1. response
data*array<>
nextCursor*|

Pass as cursor to read the next page. Null when there is no next page.

curl -X GET "https://example.com/v1/webhooks/string/deliveries" \  -H "Authorization: Bearer koast_sk_..."
{  "data": [    {      "id": "string",      "eventId": "string",      "eventType": "string",      "attempt": -9007199254740991,      "status": "succeeded",      "final": true,      "httpStatus": -9007199254740991,      "latencyMs": 0,      "responseBody": "string",      "error": "string",      "attemptedAt": "string",      "nextAttemptAt": "string",      "resend": true    }  ],  "nextCursor": "string"}

Required scope: read. CLI: koast list-webhook-deliveries, see Webhooks commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.