Docs
Webhooks

An endpoint's deliveries

GEThttps://api.norreach.app/v1/webhook-endpoints/{id}/deliveries

The delivery log, newest first (kept 30 days): status, attempts, your endpoint's answer and the exact body sent.

webhooks:readOperation id: list_webhook_deliveries
GET/webhook-endpoints/{id}/deliveries
curl -X GET "https://api.norreach.app/v1/webhook-endpoints/{id}/deliveries" \
  -H "Authorization: Bearer $NORREACH_API_KEY"
An endpoint's deliveries
{
  "object": "list",
  "data": [
    {
      "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "object": "webhook_delivery",
      "endpoint_id": "0f1a2b3c-4d5e-4f6a-8b7c-9d0e1f2a3b4c",
      "event_id": "evt_48213",
      "event_type": "lead.submitted",
      "status": "succeeded",
      "attempt": 1,
      "next_attempt_at": null,
      "response_status": 200,
      "response_ms": 182,
      "response_excerpt": "ok",
      "payload": {
        "id": "evt_48213",
        "object": "event",
        "type": "lead.submitted"
      },
      "created_at": "2026-11-04T09:12:33.120Z",
      "delivered_at": "2026-11-04T09:12:34.004Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication: send Authorization: Bearer <key>, with an API key or an OAuth access token. The key needs the scope webhooks:read. API keys and scopes

Path parameters

idstring (uuid)pathrequired

An id (UUID).

Query parameters

limitintegerquery

Page size (1–200, default 50).

cursorstringquery

The next_cursor of the previous page.

statusenumquery
One of:pendingsucceededfailedabandoned
event_typestringquery

Response

200application/json— An endpoint's deliveries

object"list"required
dataobject[]required
Show child attributes
data[].idstring (uuid)required

An id (UUID).

data[].object"webhook_delivery"required
data[].endpoint_idstring (uuid)required

An id (UUID).

data[].event_idstring | nullrequired
data[].event_typestringrequired
data[].statusenumrequired
One of:pendingsucceededfailedabandoned
data[].attemptintegerrequired
data[].next_attempt_atstring | nullrequired
data[].response_statusinteger | nullrequired
data[].response_msinteger | nullrequired
data[].response_excerptstring | nullrequired

The first 1 KB of your endpoint's answer.

data[].payloadobject | nullrequired

The exact body sent (null until the first attempt).

data[].created_atstringrequired

RFC 3339 UTC timestamp with milliseconds.

data[].delivered_atstring | nullrequired
has_morebooleanrequired
next_cursorstring | nullrequired

Errors

Errors are application/problem+json with a stable code.

StatusCodeMeaning
400bad_requestThe request couldn't be read.
400unknown_fieldThe request has a field this operation doesn't know.
400invalid_cursorThat cursor doesn't belong to this list.
401unauthorizedA valid API key is required.
403insufficient_scopeThis API key doesn't have the scope this operation needs.
403feature_not_enabledThe API isn't switched on for this workspace.
404not_foundThat doesn't exist.
429rate_limitedToo many requests. Slow down and try again.
500server_errorSomething went wrong on our side.
503unavailableThe API isn't available right now. Try again shortly.