Multiple Event Types

Overview

This endpoint enables you to retrieve logs for multiple specific event types in a single request. Instead of making separate API calls for each event type, you can combine them using multiple eventTypes parameters, allowing you to efficiently filter and retrieve exactly the event types you need.

This is particularly useful when you want to monitor specific combinations of events, such as both incoming messages and their corresponding status updates.

How Multiple Event Types Work

You can specify multiple eventTypes parameters in your request URL. Each event type will be included in the results, giving you a filtered view of only the event types you're interested in.

Supported Event Types:

Incoming%20Message - Incoming text messages

Message%20Status - Message delivery status updates

Other - Other event types

Request Parameters

Required Parameters

Parameter	Type	Description
`eventTypes`	string	Event type (can be repeated multiple times)

Optional Parameters

Parameter	Type	Description
`fromDate`	integer	Start date in Ticks format (100-nanosecond intervals since January 1, 0001 UTC). If omitted, retrieves logs from the beginning of available data.
`toDate`	integer	End date in Ticks format. If omitted, retrieves logs up to the current time.
`phoneNumberId`	string	Filter by specific WhatsApp Business phone number ID
`url`	string	Filter by specific webhook URL (URL encoded)
`pageSize`	integer	Number of log entries to return per page. Default: 20, Maximum: 20
`nextPageToken`	string	Token for pagination to retrieve the next page of results. Use the `next_page_token` value from the previous response.

Date Format Specification

Dates are specified in Ticks format: 100-nanosecond intervals since January 1, 0001 at 00:00:00 UTC.

Example: 638000000000000000

Request Examples

Multiple Event Types - Basic Request

Retrieve both Message Status and Other event types without date filters:

Or with date range:

Multiple Event Types with Phone Number Filter

Filter by phone number and retrieve multiple event types:

Multiple Event Types with Webhook URL Filter

Filter by webhook URL and retrieve multiple event types:

All Three Event Types

Retrieve Incoming Message, Message Status, and Other events:

With Page Size

Response Structure

The response contains logs from all specified event types, mixed together and sorted by creation time:

{
    "message": "Notification logs retrieved successfully",
    "data": {
        "logs": [
            {
                "project_id": "12345",
                "phone_number_id": "123456789012345",
                "event_type": "Message Status",
                "payload": "{\"object\":\"whatsapp_business_account\",\"entry\":[{\"id\":\"123456789012345\",\"changes\":[{\"field\":\"messages\",\"value\":{\"messaging_product\":\"whatsapp\",\"metadata\":{\"display_phone_number\":\"15551234567\",\"phone_number_id\":\"123456789012345\"},\"statuses\":[{\"id\":\"msg_ABC123XYZ\",\"recipient_id\":\"1234567890\",\"status\":\"delivered\",\"timestamp\":\"1704067200\",\"conversation\":{\"id\":\"5f7375311518ef490638d5b08aee9eb5\",\"origin\":{\"type\":\"service\"}},\"pricing\":{\"pricing_model\":\"PMP\",\"billable\":false,\"category\":\"service\"}}]}}]}]}",
                "created_at": 638500000000000000,
                "direction": 1,
                "flyout_delivery_status": "-",
                "flyout_delivery_response": "-",
                "flyout_delivery_response_code": 0,
                "flyout_url": "-"
            },
            {
                "project_id": "12345",
                "phone_number_id": "123456789012345",
                "event_type": "Incoming Message",
                "payload": "{\"object\":\"whatsapp_business_account\",\"entry\":[{\"id\":\"123456789012345\",\"changes\":[{\"field\":\"messages\",\"value\":{\"messaging_product\":\"whatsapp\",\"metadata\":{\"display_phone_number\":\"15551234567\",\"phone_number_id\":\"123456789012345\"},\"contacts\":[{\"wa_id\":\"1234567890\",\"profile\":{\"name\":\"John Doe\"}}],\"messages\":[{\"from\":\"1234567890\",\"id\":\"wamid.HBgMDEyMzQ1Njc4OTAFQIAEhgWM0VCMDI5NTg3MDU0MDIxQUVCMzA0RgA=\",\"timestamp\":\"1704067200\",\"type\":\"text\",\"text\":{\"body\":\"Hello, this is a test message\"}}]}}]}]}",
                "created_at": 638500000100000000,
                "direction": 1,
                "flyout_delivery_status": "-",
                "flyout_delivery_response": "-",
                "flyout_delivery_response_code": 0,
                "flyout_url": "-"
            }
        ],
        "next_page_token": "eyJQcm9qZWN0SWQiOnsiTiI6IjEyMzQ1In0sIkNyZWF0ZWRBdCI6eyJOOiI2Mzg1MDAwMDAwMDAwMDAwMCJ9fQ=="
    }
}

Response Fields

Response Object

Field	Type	Description
`message`	string	Success message
`data`	object	Response data container

Data Object

Field	Type	Description
`data.logs`	array	Array of log entries from all specified event types
`data.next_page_token`	string	Pagination token for next page

Log Entry Fields

Each log entry contains:

Field	Type	Description
`project_id`	string	Project identifier
`phone_number_id`	string	WhatsApp Business phone number ID
`event_type`	string	Event type: "Incoming Message", "Message Status", or "Other"
`payload`	string	JSON string with full webhook payload
`created_at`	integer	Timestamp in Ticks format
`direction`	integer	Message direction (1 = incoming)
`flyout_delivery_status`	string	Flyout delivery status
`flyout_delivery_response`	string	Flyout delivery response
`flyout_delivery_response_code`	integer	HTTP response code for flyout
`flyout_url`	string	Flyout notification URL

Filtering Results by Event Type

Since the response contains multiple event types, you can filter them in your application:

Pagination

When there are more results available, the response includes a next_page_token. To retrieve the next page, include the nextPageToken parameter with all original parameters:

Continue this process until no next_page_token is returned in the response.

Error Responses

400 Bad Request

{
    "message": "Invalid request parameters",
    "data": null
}

401 Unauthorized

{
    "message": "Unauthorized"
}

403 Forbidden

{
    "message": "Forbidden"
}

500 Internal Server Error

{
    "message": "Internal server error",
    "data": null
}

Important Notes

Event Type Filtering: Only logs matching the specified event types are returned

Mixed Results: Results from different event types are interleaved by timestamp

URL Encoding: All eventTypes values must be URL encoded

Parameter Repetition: Repeat the eventTypes parameter for each event type you want

7-Day Retention: Logs are only available for the last 7 days

Payload Parsing: The payload field is a JSON string that must be parsed

Use Cases

Message Lifecycle Tracking: Retrieve both incoming messages and their status updates together

Selective Monitoring: Monitor specific event combinations without retrieving all events

Efficient Data Retrieval: Reduce API calls by combining multiple event types

Correlation Analysis: Analyze relationships between different event types

Targeted Auditing: Create focused audit logs for specific event combinations

Code Example

Best Practices

Limit Event Types: Only request the event types you actually need

Use Filters: Combine with phoneNumberId or url filters to narrow results

Handle Pagination: Always check for and use next_page_token when present

Parse Payloads: Remember to parse the JSON string in the payload field

Filter Client-Side: Use the event_type field to separate results if needed

Retrieve All Event Logs - Get all event types without filtering

Retrieve Incoming Message Logs - Get incoming messages only

Retrieve Message Status Logs - Get status updates only

Retrieve Other Event Logs - Get other event types only

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Overview#

How Multiple Event Types Work#

Request Parameters#

Required Parameters#

Optional Parameters#

Date Format Specification#

Request Examples#

Multiple Event Types - Basic Request#

Multiple Event Types with Phone Number Filter#

Multiple Event Types with Webhook URL Filter#

All Three Event Types#

With Page Size#

Response Structure#

Response Fields#

Response Object#

Data Object#

Log Entry Fields#

Filtering Results by Event Type#

Pagination#

Error Responses#

400 Bad Request#

401 Unauthorized#

403 Forbidden#

500 Internal Server Error#

Important Notes#

Use Cases#

Code Example#

Best Practices#

Related Endpoints#

Request

Responses