---
url: https://docs.youcan.shop/youcan-pay/webhook-history/list.md
---
# 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-history`
**Method:** `GET`

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

## Response

```json
{
  "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](/youcan-pay/webhook-history/object) for a description of each field.