Retrieve a delivery

Read one webhook delivery — the payload Localoy sent, its attempts, and how your endpoint answered.

GET{BASE_URL}/webhooks/deliveries/{id}

Returns one delivery: one event sent to one of your endpoints, with the exact payload and the outcome of its latest attempt. Requires a provider key; the partner header is ignored. Use it to debug a receiver.

Path parameters

idstringrequired: The delivery's ID — also sent to your endpoint as X-Localoy-Delivery-Id.

The delivery

idstringrequired: The delivery's ID.
endpointIdstringrequired: The endpoint it was sent to.
partnerIdstring | nullrequired: The partner the event is about. null on a test ping, which is about none of your partners.
endpointUrlstringrequired: That endpoint's URL as it is now.
eventIdstringrequired: The event's ID, as in X-Localoy-Event-Id. A replay keeps it.
eventstringrequired: The event type, such as booking.created.
statusstringrequired: PENDING, SUCCEEDED or FAILED.
attemptsintegerrequired: Attempts made so far.
nextAttemptAtstring | nullrequired: When the next attempt is due. null unless status is PENDING.
responseStatusinteger | nullrequired: Your endpoint's HTTP status on the latest attempt.
responseBodystring | nullrequired: The start of your endpoint's answer, up to 2,048 characters.
lastErrorstring | nullrequired: Why the latest attempt failed, such as Receiver returned 503 or Receiver did not respond within 10s.
durationMsinteger | nullrequired: How long the latest attempt took.
deliveredAtstring | nullrequired: When your endpoint accepted it.
isTestbooleanrequired: true for a test ping and for a replay.
payloadobjectrequired: The envelope Localoy sent — id, event, occurredAt, environment, partnerId and data.
createdAtstringrequired: When the delivery was created, ISO 8601 UTC.
updatedAtstringrequired: When it last changed.

Status codes#

Status	Code	Meaning
`200`	—	Success.
`403`	`provider_key_required`	A partner key made the call.
`404`	`webhook_delivery_not_found`	You have no delivery with that ID.

curl "$LOCALOY_BASE_URL/webhooks/deliveries/cm8d3l1v3ry0000000000001" \
  -H "Authorization: Bearer $LOCALOY_PROVIDER_KEY"

Response · 200

{
  "success": true,
  "data": {
    "id": "cm8d3l1v3ry0000000000001",
    "endpointId": "cm8wh00k0000000000000001",
    "partnerId": "cm1partnerid000000000000001",
    "endpointUrl": "https://hooks.example.com/localoy",
    "eventId": "evt_mfz3k2a1Xq9vT0bLm3Rk",
    "event": "booking.created",
    "status": "FAILED",
    "attempts": 6,
    "nextAttemptAt": null,
    "responseStatus": 503,
    "responseBody": "Service Unavailable",
    "lastError": "Receiver returned 503",
    "durationMs": 212,
    "deliveredAt": null,
    "isTest": false,
    "payload": {
      "id": "evt_mfz3k2a1Xq9vT0bLm3Rk",
      "event": "booking.created",
      "occurredAt": "2026-09-27T11:05:42.230Z",
      "environment": "production",
      "partnerId": "cm1partnerid000000000000001",
      "data": { "booking": { "…": "…" } }
    },
    "createdAt": "2026-09-27T11:05:42.230Z",
    "updatedAt": "2026-09-27T11:10:44.905Z"
  }
}