List All Webhook History

Returns a paginated list of webhook delivery attempts for the current authenticated account, across every webhook. The list is sorted, with the most recent attempts appearing first by default.

Required scope (OAuth only): view-webhook-history-events

Parameters

Parameter	Type	Description
sort_field	string optional	Field you want to sort by. Defaults to created_at.
sort_order	string optional	Sorting order, asc or desc. Defaults to desc.
page	integer optional	Page number. Defaults to 1.
limit	integer optional	Page size. Defaults to 10, capped at 50.

Returns

Returns a paginated collection of webhook history objects. If nothing has been delivered yet, returns an empty collection.

Request

Endpoint: https://youcanpay.com/api/v2/webhook-historyMethod: GET

$ curl --location -g --request GET 'https://youcanpay.com/api/v2/webhook-history' \
  --header 'Accept: application/json' \
  -u 'YOUR_PRIVATE_KEY:'

Response

{
  "object": "v2.webhook_history",
  "data": [
    {
      "object": "v2.webhook_history",
      "id": "6f2e1a0b-7c8d-4e9f-a0b1-c2d3e4f5a6b7",
      "webhook_id": "9b1f2c34-5d6e-4a7b-8c9d-0e1f2a3b4c5d",
      "event_name": "transaction.paid",
      "status": "success",
      "url": "https://example.com/webhooks/youcan-pay",
      "entity_id": "10e7691c-14a2-4936-833b-ec154c817ce9",
      "data": {},
      "attempts": 1,
      "max_attempts": 3,
      "will_retry": false,
      "response": {
        "status_code": 200,
        "body": "OK"
      },
      "last_attempted_at": "2026-09-09 11:58:03",
      "created_at": "2026-09-09 11:58:02"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 10,
    "total": 1,
    "last_page": 1
  }
}

See the Webhook History object for a description of each field.