API reference

Event log

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. Errors follow the two-source contract.

Operations on this page:

GET /v1/events: Search the event log
GET /v1/events/{event_id}: Get one event with its full envelope and deliveries

#Search the event log

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:

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

bash

Responses

200 Event metadata, newest first

{
  "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"
}

json

#Get one event with its full envelope and deliveries

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:

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

bash

Responses

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

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

json

This page as Markdown: /api/events.md. All docs in one file: /llms-full.txt.

Start

Guides

API reference

Webhook events

Reference

Event log

#Search the event log

#Get one event with its full envelope and deliveries