Documentation menu

← Webhooks

API reference

Retrieve a delivery

GET/v1/webhook/{webhook}/delivery/{delivery}

Retrieves a delivery with its signed body and every attempt, including the headers sent.

Deliveries stay available after their webhook is deleted.

Parameters

path

webhookrequiredstring
The webhook's id, whk_....
deliveryrequiredstring
The delivery's id, whd_....

Responses

200
Delivery
The webhook delivery.
401
ProblemDetail
credential_missing, credential_invalid or credential_expired. The request has no valid credential.
403
ProblemDetail
scope_missing, person_required, api_key_not_accepted or entitlement_missing. The credential or plan does not allow this request. detail names the reason.
404
ProblemDetail
no_such_resource. No object has that id.
422
ProblemDetail
parameter_invalid, id_malformed or a cursor code. A parameter is missing or invalid. errors lists each one.
429
ProblemDetail
rate_limited. Too many requests. Retry after the Retry-After interval. Nothing is charged.

Credits

Free.

Example request

curl -X GET 'https://api.placestack.com/v1/webhook/018f4b75-6f79-7c6a-8c80-000000000001/delivery/018f4b75-6f79-7c6a-8c80-000000000001' \
  -H "Authorization: Bearer $PLACESTACK_API_KEY"

Example response

{
  "object": "webhook_delivery",
  "id": "whd_01h455vb4pex5vsknk084sn02q",
  "seq": 1,
  "event_type": "permit.created",
  "synthetic": true,
  "subject": "whk_01h455vb4pex5vsknk084sn02q",
  "body": {},
  "body_sha256": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b",
  "state": "pending",
  "attempt_count": 1,
  "next_attempt_at": "2026-09-13T12:00:00Z",
  "delivered_at": "2026-09-13T12:00:00Z",
  "dead_lettered_at": "2026-09-13T12:00:00Z",
  "response_status": 1,
  "response_body_head": "{\"received\": true}",
  "error": "Connection timed out after 10 seconds.",
  "created_at": "2026-09-13T12:00:00Z",
  "attempt": [
    {
      "attempt": 1,
      "attempted_at": "2026-09-13T12:00:00Z",
      "duration_ms": 1,
      "timestamp": 1,
      "signature": "v1,K5oZfzN95Z9UVu1EsfQmfVNQhnkZ2pj9o9NDN/H/pI4=",
      "response_status": 1,
      "response_body_head": "{\"received\": true}",
      "error": "Connection timed out after 10 seconds."
    }
  ]
}

Next steps

Account

The credential making the request, its scopes and its credit balance.

Continue