Skip to main content
Debugging Webhooks
  • Check status to see if delivery succeeded
  • Review response_code for HTTP status
  • Read error field for failure details
  • Use attempt to track retries
Filter by endpoint_id to debug a specific webhook endpoint.
GET
/
v1
/
webhooks
/
deliveries
List webhook deliveries
curl --request GET \
  --url https://api.peepal.dev/v1/webhooks/deliveries \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "id": "<string>",
      "endpoint_id": "<string>",
      "event_type": "job.created",
      "job_id": "<string>",
      "attempt": 2,
      "status": "success",
      "response_code": 123,
      "error": "<string>",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "next_cursor": "<string>"
}
Retrieve a paginated list of webhook delivery attempts, with optional filtering by endpoint.

​
Delivery Status

  • success: Webhook delivered successfully (2xx response)
  • failure: Webhook delivery failed (non-2xx response or timeout)
curl -X GET "https://api.peepal.dev/v1/webhooks/deliveries?limit=25&endpoint_id=wh_01ARZ3NDEKTSV4RRFFQ69G5FAV" \
  -H "x-api-key: YOUR_API_KEY"

{
  "data": [
    {
      "id": "del_01ARZ3NDEKTSV4RRFFQ69G5FAV",
      "endpoint_id": "wh_01ARZ3NDEKTSV4RRFFQ69G5FAV",
      "event_type": "job.completed",
      "job_id": "job_01ARZ3NDEKTSV4RRFFQ69G5FAV",
      "attempt": 1,
      "status": "success",
      "response_code": 200,
      "error": null,
      "created_at": "2025-12-31T10:02:35Z"
    }
  ],
  "next_cursor": null
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
limit
integer
default:25
Required range: 1 <= x <= 100
​
cursor
string
​
endpoint_id
string

Response

Paginated deliveries

​
data
object[]
required
​
next_cursor
string | null
required