Skip to main content
GET
Get Messages

Authorizations

Authorization
string
header
required

Secret key in Bearer sk_... format. Server-to-server only — never embed it in a browser or mobile client. The organization is resolved from the key, so organization_id is never passed explicitly.

Query Parameters

appId
string[]

Repeatable. Omit to include every app in the organization, or repeat it (?appId=app_AAA&appId=app_BBB) to scope to specific apps. An ID that does not belong to the organization returns 404.

startDate
string<date-time>

ISO-8601 datetime. Start of the range. Defaults to today 00:00:00 UTC.

Example:

"2026-06-01T00:00:00"

endDate
string<date-time>

ISO-8601 datetime. End of the range; must be greater than startDate. Defaults to today 23:59:59 UTC.

Example:

"2026-06-08T00:00:00"

granularity
enum<string>
default:daily

How the series is bucketed. Any other value returns 422.

Available options:
hourly,
daily,
weekly,
monthly

Response

Summary totals plus the bucketed series.

data
object
isSuccess
enum<boolean>
Available options:
true