> ## Documentation Index
> Fetch the complete documentation index at: /docs/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 via the Mailofly API.

### Query Parameters

**webhook\_id** `string`

Filter events by specific webhook destination ID.

**limit** `number` (default: 20)

Number of events to retrieve (max 100).

### Response

**data** `array`

**id** `string`

Event ID.

**webhook\_id** `string`

Target webhook ID.

**event** `string`

Event type (e.g. `email.delivered`).

**status** `string`

Status: `succeeded`, `failed`, `delivering`, `pending`.

**status\_code** `number`

Destination HTTP response code.

**attempt\_count** `number`

Total delivery attempts.

**created\_at** `string`

Timestamp.

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

```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"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.