> ## Documentation Index
> Fetch the complete documentation index at: https://resend.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Events

> Retrieve a list of events delivered to a webhook.

## Path Parameters

<ParamField path="webhook_id" type="string" required>
  The Webhook ID.
</ParamField>

## Query Parameters

<ParamField query="limit" type="number">
  Number of events to return. Between `1` and `100`. Defaults to `20`.
</ParamField>

<ParamField query="after" type="string">
  The event ID to fetch the next page after.

  The `before` parameter is not supported for this endpoint.
</ParamField>

## Response Fields

<ParamField body="object" type="string">
  Always `list`.
</ParamField>

<ParamField body="has_more" type="boolean">
  Whether more events exist beyond this page.
</ParamField>

<ParamField body="data" type="array">
  The events delivered to this webhook, most recent first.

  <Expandable defaultOpen="true" title="properties">
    <ParamField body="id" type="string">
      The event ID. Use this to [retrieve its details](/docs/api-reference/webhooks/get-event)
      or [list its attempts](/docs/api-reference/webhooks/list-event-attempts).
    </ParamField>

    <ParamField body="type" type="string">
      The event type, for example `email.sent`.
    </ParamField>

    <ParamField body="created_at" type="string">
      When the event was created.
    </ParamField>

    <ParamField body="status" type="string">
      Delivery status of the event to this webhook: `success`, `failed`,
      `attempting`, or `pending`.
    </ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"vesper"}}
  curl -X GET 'https://api.resend.com/webhooks/4dd369bc-aa82-4ff3-97de-514ae3000ee0/events' \
       -H 'Authorization: Bearer re_xxxxxxxxx'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={"theme":{"light":"github-light","dark":"vesper"}}
  {
    "object": "list",
    "has_more": false,
    "data": [
      {
        "id": "msg_1srOrx2ZWZBpBUvZwXKQmoEYga2",
        "type": "email.sent",
        "created_at": "2026-08-22T15:28:00.000Z",
        "status": "success"
      },
      {
        "id": "msg_1srOsB4mXhCqCVwAxYRNnpFZhb3",
        "type": "email.delivered",
        "created_at": "2026-08-22T15:27:42.000Z",
        "status": "failed"
      }
    ]
  }
  ```
</ResponseExample>