# Event log

> The event log. Bodies are kept for your retention period (30/90/180/365 days); metadata longer.

Canonical: https://docs.whabuzz.com/api/events/

The event log. Bodies are kept for your retention period (30/90/180/365 days); metadata longer.

Base URL `https://api.whabuzz.com`. Every request needs `Authorization: Bearer <key>` unless the operation says otherwise; see [Authentication](https://docs.whabuzz.com/authentication.md). Errors follow the [two-source contract](https://docs.whabuzz.com/errors.md).

Operations on this page:

- [`GET /v1/events`](#listEvents): Search the event log
- [`GET /v1/events/{event_id}`](#getEvent): Get one event with its full envelope and deliveries

## Search the event log {#listEvents}

`GET /v1/events`

**Auth:** API key (tenant key, or app key with `X-WhaBuzz-Tenant`). **Operation id:** `listEvents`.

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `type` | query | `*` or `message.inbound` or `message.status` or `message.error` or `message.echo` or `message.outbound` or `user.preferences` or `batch.completed` or `template.status` or `template.quality` or `template.category` or `number.quality` or `number.name` or `number.connection` or `account.update` or `account.alerts` or `account.capability` or `account.security` or `token.expiring` or `token.invalid` or `meta.other` | no |  |
| `phone_number_id` | query | string | no |  |
| `wamid` | query | string | no |  |
| `wa_id` | query | string | no |  |
| `error_code` | query | integer | no |  |
| `from` | query | string (date-time) | no |  |
| `to` | query | string (date-time) | no |  |
| `limit` | query | integer | no |  |
| `cursor` | query | string | no | `next_cursor` from the previous page. |

cURL:

```bash
curl -X GET "https://api.whabuzz.com/v1/events" \
  -H "Authorization: Bearer $WHABUZZ_KEY"
```

**Responses**

**200** Event metadata, newest first

```json
{
  "data": [
    {
      "id": "evt_01JAB3K9X2S8C4M7Q1V5R6T0YZ",
      "type": "message.status",
      "created_at": "2026-10-16T05:12:03.481Z",
      "phone_number_id": "1013622581841046",
      "wamid": "wamid.HBgLMTY1MDU1NTEyMzQVAgASGBQzQUY5QTdGNkU0RTFGMkI3QzFBNDMAAA=",
      "wa_id": "16505551234",
      "status": "failed",
      "error_codes": [
        131049
      ]
    }
  ],
  "next_cursor": "evt_01JAB3J8W1R7B3L6P0U4Q5S9XY"
}
```

## Get one event with its full envelope and deliveries {#getEvent}

`GET /v1/events/{event_id}`

**Auth:** API key (tenant key, or app key with `X-WhaBuzz-Tenant`). **Operation id:** `getEvent`.

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `event_id` | path | string | yes |  |

cURL:

```bash
curl -X GET "https://api.whabuzz.com/v1/events/$EVENT_ID" \
  -H "Authorization: Bearer $WHABUZZ_KEY"
```

**Responses**

**200** Event. `envelope` is null once the body is past retention.

```json
{
  "id": "evt_01JAB3K9X2S8C4M7Q1V5R6T0YZ",
  "type": "message.inbound",
  "created_at": "2026-10-16T05:12:03.481Z",
  "envelope": {
    "note": "Same shape as the message.inbound webhook example (components.examples.EnvelopeInbound)"
  },
  "deliveries": [
    {
      "id": "dlv_01JAB3K9X3T9D5N8R2W6S7U1Z0",
      "endpoint_id": "3c2b1a09-f8e7-4d6c-b5a4-9382716a5b4c",
      "status": "delivered",
      "attempts": 1,
      "last_http_status": 200
    }
  ]
}
```