Webhooks

List webhook deliveries

Changed on

Returns a paginated list of deliveries for a webhook endpoint. Delivery history is retained for 30 days — older records are automatically removed.

get/v4/webhook_endpoints/{id}/deliveries

Request

  • Base URL
    https://api.kit.com
  • URL
    https://api.kit.com/v4/webhook_endpoints/{id}/deliveries
  • Auth
    • API key in header X-Kit-Api-Key
    • or OAuth 2
      Authorization code: https://api.kit.com/v4/oauth/authorize
      Token URL: https://api.kit.com/v4/oauth/token

Path parameters

idinteger required

Query parameters

afterunknown

To fetch next page of results, use ?after=<end_cursor>

beforeunknown

To fetch previous page of results, use ?before=<start_cursor>

event_typestring

Filter deliveries by event type. See Event Types for the full list of supported values.

per_pageunknown

Number of results per page. Default 500, maximum 1000.

status'pending' | 'delivered' | 'failed' | 'retrying'

Filter deliveries by status. One of: pending, delivered, failed, retrying.

Response

Returns 200 and a list of deliveries for the endpoint in descending order

Changes