Webhooks
List Webhook Deliveries
List delivery attempts for a webhook.
GET /v1/webhooks/{webhook_id}/deliveries returns delivery attempts for one webhook. Use it to troubleshoot missed callbacks, receiver failures, or repeated retry attempts.
Request
The example below lists the first page of delivery attempts for a webhook.
export SCRAPER_API_BASE_URL="https://scraper.geonode.io"
export GEONODE_SCRAPER_API_KEY="YOUR_API_KEY"
curl "$SCRAPER_API_BASE_URL/v1/webhooks/2a936d3b-5a5d-47a0-b68d-5df0d8b8327c/deliveries?page=1&page_size=100" \
-H "X-Api-Key: $GEONODE_SCRAPER_API_KEY"You can also pass a status query parameter to filter delivery attempts by status. Valid status values are pending, success, failed, and abandoned.
curl "$SCRAPER_API_BASE_URL/v1/webhooks/2a936d3b-5a5d-47a0-b68d-5df0d8b8327c/deliveries?status=abandoned" \
-H "X-Api-Key: $GEONODE_SCRAPER_API_KEY"Query Parameters
Use pagination for long delivery histories, and status when you only want to inspect one class of delivery outcome.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | 1 | Page number. Must be greater than 0. |
page_size | integer | No | 100 | Results per page. Maximum is 100. |
status | string or null | No | null | Optional delivery status filter. |
Response
Delivery records include the event type, related job ID when available, attempt number, delivery status, receiver HTTP status, and timestamps.
{
"items": [
{
"id": "395cf7e2-41e0-4e44-85f1-5f00f537a44f",
"event_type": "batch_completed",
"job_id": "9d7b2c8e-8a4b-4c10-9af3-65f4f8f6c019",
"attempt_number": 1,
"status": "success",
"http_status": 200,
"delivered_at": "2026-05-27T08:16:10Z",
"created_at": "2026-05-27T08:16:09Z"
}
],
"page": 1,
"page_size": 100,
"page_count": 1
}