RevKeen Docs
Api reference

List webhook deliveries

List individual webhook delivery attempts across all endpoints for the authenticated merchant. Use filters to scope to a specific endpoint, a specific event, or a specific delivery status. Results are returned in reverse chronological order.

Related endpoints

  • GET /webhook-deliveries/{id} — Retrieve a webhook delivery
  • POST /webhook-deliveries/{id}/retry — Retry a webhook delivery

Common errors

  • 401 unauthenticated — missing, malformed, or revoked API key.

Pagination

Offset-based with limit (default 25, max 100) and offset. The response pagination block includes total and hasMore. See the pagination guide for SDK auto-paging helpers.

GET
/webhook-deliveries

Authorization

x-api-key<token>

Your RevKeen API key (powered by Unkey). Get it from Dashboard > Settings > API Keys. Use rk_sandbox_* for test mode and rk_live_* for production.

In: header

Query Parameters

endpoint_id?string

Filter by webhook endpoint ID

Formatuuid
event_id?string

Filter by source event ID

Formatuuid
status?string

Filter by delivery status

Value in"pending" | "succeeded" | "failed" | "dead_lettered"
limit?integer
Default20
Range1 <= value <= 100
starting_after?string

Cursor — return deliveries created before the row with this ID.

Formatuuid
ending_before?string

Cursor — return deliveries created after the row with this ID.

Formatuuid

Response Body

application/json

application/json

curl "https://api.revkeen.com/v2/webhook-deliveries" \  -H "x-api-key: $REVKEEN_API_KEY"
{
  "object": "list",
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "object": "webhook_delivery",
      "endpoint_id": "7c1cbf21-0b6c-4c27-9d60-8a9f0a7e6d91",
      "event_id": "1f8d9e0b-3a2e-4d9a-b0fe-1c2a3f4d5e6f",
      "event_type": "invoice.paid",
      "status": "pending",
      "attempts": 2,
      "max_attempts": 8,
      "last_status_code": 502,
      "last_error": "connect ETIMEDOUT",
      "last_error_code": "ETIMEDOUT",
      "last_duration_ms": 1532,
      "last_attempt_at": "2019-08-24T14:15:22Z",
      "next_retry_at": "2019-08-24T14:15:22Z",
      "delivered_at": "2019-08-24T14:15:22Z",
      "dead_lettered_at": "2019-08-24T14:15:22Z",
      "dead_letter_reason": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "has_more": true,
  "url": "string"
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
Edit on GitHub