Sign in

v1

latestOpenAPI 3.0.32026-07-26870417.2 KB
chats

List All Notifications

This endpoint retrieves a paginated list of all notifications across chats (in descending order of timestamp)

get/chats/notifications

Query parameters

offsetnumber
  • The offset value for paginating the results
  • Default 0
limitnumber
  • The maximum number of notifications to retrieve
  • Default 2000
start_timestring
  • The start_time to filter the results
Example:2025-04-25 or 2025-04-25T00:00:00Z
end_timestring
  • The end_time to filter the results
Example:2025-04-31

Headers

x-phonestring
Example:{{orgPhone}}

Optional. The phone to scope this request to — in country code + number format with no spaces or special characters (e.g. 919876543210), or the phone_id (phone-xxxxxxxxxxxx). When set, only notifications for that phone are returned. When omitted, notifications are returned — across all phones your token can access (the phones in your token's scope, or every phone in your organization if the token is unscoped). Passing a phone that is outside your token's scope returns a 401.

Response

fromnumber

The starting index of the returned notifications.

tonumber

The ending index of the returned notifications.

countnumber

The total count of notifications.

Example response

{
  "from": 1,
  "to": 10,
  "count": 10
}