List delivery logs

curl --request GET \
  --url https://api.paystack.com/v1/notifications/webhooks/{id}/logs \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Webhook delivery logs retrieved",
  "code": "ok",
  "data": [
    {
      "event_idempotency_key": "evt-1",
      "topic": "onramp.success",
      "delivery_status": "delivered",
      "attempt_number": 1,
      "success": true,
      "created_at": "2026-05-26T12:00:00.000Z",
      "http_status": 200,
      "error_message": null,
      "latency_ms": 142
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 50,
    "total": 137,
    "has_more": false,
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Notification Webhooks

List delivery logs

Returns the delivery-attempt history for a webhook endpoint, newest first. Each row records one attempt to deliver one event: which event (event_idempotency_key + topic), the delivery leg’s status, the attempt number, whether it succeeded, the HTTP status the endpoint returned, any error message, and the round-trip latency.

Use this to debug why an endpoint is or isn’t receiving events.

Pagination

page — 1-indexed page number. Defaults to 1. Between 1 and 1,000,000.
per_page — page size. Defaults to 50. Between 1 and 200.

The response carries pagination metadata under meta (page, per_page, total, has_more).

Example

GET /v1/notifications/webhooks/whr_01HXYZABC1234567890ABCDEFG/logs?page=1&per_page=50

GET

notifications

webhooks

{id}

logs

List delivery logs

curl --request GET \
  --url https://api.paystack.com/v1/notifications/webhooks/{id}/logs \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Webhook delivery logs retrieved",
  "code": "ok",
  "data": [
    {
      "event_idempotency_key": "evt-1",
      "topic": "onramp.success",
      "delivery_status": "delivered",
      "attempt_number": 1,
      "success": true,
      "created_at": "2026-05-26T12:00:00.000Z",
      "http_status": 200,
      "error_message": null,
      "latency_ms": 142
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 50,
    "total": 137,
    "has_more": false,
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Authorizations

Authorization

string

header

required

API key issued during merchant onboarding.

Path Parameters

string

required

Webhook endpoint id (whr_…).

Pattern: [^\/#\?]+?

Example:

"whr_01HXYZABC1234567890ABCDEFG"

Query Parameters

page

integer

default:1

1-indexed page number.

Required range: 1 <= x <= 1000000

Example:

1

per_page

integer

default:50

Page size (1–200).

Required range: 1 <= x <= 200

Example:

50

Response

Webhook delivery logs retrieved

status

enum<boolean>

required

Available options:

true

Example:

true

message

string

required

Human-readable summary

Example:

"Webhook delivery logs retrieved"

code

enum<string>

required

Available options:

ok

Example:

"ok"

data

object[]

required

Show child attributes