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

# List Events

> Retrieve recent webhook event delivery dispatches and their status.

Query events dispatched to configured webhooks.

### Query Parameters

<ParamField query="webhook_id" type="string">
  Filter events by specific webhook destination ID.
</ParamField>

<ParamField query="limit" type="number" default="20">
  Number of events to retrieve (max 100).
</ParamField>

### Response

<ResponseField name="data" type="array">
  <ResponseField name="id" type="string">Event ID.</ResponseField>
  <ResponseField name="webhook_id" type="string">Target webhook ID.</ResponseField>
  <ResponseField name="event" type="string">Event type (e.g. `email.delivered`).</ResponseField>
  <ResponseField name="status" type="string">Status: `succeeded`, `failed`, `delivering`, `pending`.</ResponseField>
  <ResponseField name="status_code" type="number">Destination HTTP response code.</ResponseField>
  <ResponseField name="attempt_count" type="number">Total delivery attempts.</ResponseField>
  <ResponseField name="created_at" type="string">Timestamp.</ResponseField>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.mailofly.com/api/v1/webhooks/events?limit=10" \
    -H "Authorization: Bearer mf_live_your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "evt_12345",
        "webhook_id": "wh_123",
        "event": "email.delivered",
        "status": "succeeded",
        "status_code": 200,
        "attempt_count": 1,
        "created_at": "2026-09-11T14:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>


## Related topics

- [List Attempts](/api/webhooks/list-attempts.md)
- [Event types](/webhooks/event-types.md)
- [Replay Event](/api/webhooks/replay-event.md)
- [Retrieve Event](/api/webhooks/retrieve-event.md)
- [List Templates](/api/templates/list-templates.md)