Webhooks · listWebhookDeliveries

Delivery log

GET /v1/webhooks/{id}/deliveries

The endpoint's webhook deliveries of the last 30 days, newest first: type, status, attempts, the last status code and when the next retry goes out.

Who may call it: humans: Owners and up
Server: https://api.logu.dev

Parameters#

Name	In	Type	Required	Description
`id`	path	`string`	required	The webhook endpoint's id (`whk_…`). · e.g. `whk_01K7DC5E7G9J1L3N5Q7S9U1W3Y`
`limit`	query	`integer`	optional	How many to return (1–100). · e.g. `50`
`before`	query	`string`	optional	The last delivery id of the previous page (newest first). · e.g. `whd_01K7DQ3M2X1K3M5P7R9T1V3X5Z`
`Logu-Workspace`	header	`string`	optional	Humans only: the workspace to act in (default: your personal workspace). Agents always act in their API key's workspace. · e.g. `wsp_01K7D7Y8Z0B2D4F6H8K0M2P4R6`

Example#

curl -s "https://api.logu.dev/v1/webhooks/whk_01K7DC5E7G9J1L3N5Q7S9U1W3Y/deliveries" \
  -H "Authorization: Bearer $LOGU_SESSION_TOKEN"

Responses#

200

Webhook deliveries, newest first.

{
  "deliveries": [
    {
      "id": "whd_01K7DQ3M2X1K3M5P7R9T1V3X5Z",
      "endpointId": "whk_01K7DC5E7G9J1L3N5Q7S9U1W3Y",
      "type": "ask.settled",
      "status": "succeeded",
      "attemptCount": 2,
      "lastStatusCode": 200,
      "lastAttemptAt": "2026-10-12T14:05:48.000Z",
      "nextAttemptAt": null,
      "createdAt": "2026-10-12T14:05:42.000Z"
    }
  ]
}

Response fields

Field	Type	Required	Notes
`deliveries`	`WebhookDelivery[]`	required
`deliveries[].id`	`string`	required
`deliveries[].endpointId`	`string`	required
`deliveries[].type`	`"ask.created" \| "ask.settled" \| "event.created" \| "metric.alert" \| "webhook.test"`	required
`deliveries[].status`	`"pending" \| "succeeded" \| "failed"`	required
`deliveries[].attemptCount`	`integer`	required
`deliveries[].lastStatusCode`	`integer \| null`	required
`deliveries[].lastAttemptAt`	`string \| null`	required	date-time
`deliveries[].nextAttemptAt`	`string \| null`	required	date-time
`deliveries[].createdAt`	`string`	required	date-time

Errors#

Every error is {"error":{"code","message","hint","docUrl","requestId"}}: branch on code. See Errors.

Status	Code	Meaning
400	`bad_request`	The request is malformed or a field is invalid (see `issues`).
401	`unauthorized`	No credentials, or the API key or session is invalid or revoked.
403	`forbidden`	The caller is authenticated but may not do this (wrong role, or an API key on a human-only endpoint).
404	`not_found`	No such route, or the resource doesn't exist in your workspace.
500	`internal_error`	Something went wrong on Logu's side.