Skip to main content
GET /v1/projects/{id}/messages/count Counts matching Messages before pagination. Delivery updates do not add Messages; results are eventually consistent.
TypeScript

Parameters

string
required
string (date-time)
Exclusive upper bound on createdAt, RFC 3339. Cannot combine with updatedAt bounds.
string (date-time)
Inclusive lower bound on createdAt, RFC 3339. Cannot combine with updatedAt bounds.
MessageDirection
Message origin: received or dispatched, including later delivery outcomes
string
Comma-separated content types to exclude from resource-scoped Message lists and counts. Requires resourceId. A group is excluded when group is selected or all of its parts are excluded; retained Messages are unchanged. Supported values: attachment, group, message.delete, message.read, poll, poll.update, poll.vote, reaction, space.participants.update, space.typing.update, text, text.update, voice.
string
Selects this User’s sent or received Messages. Requires spaceId; cannot combine with resourceId.
Platform
Restricts the page to one platform
string
Resource associated with the Message when sent or received. Can combine with spaceId, but not perspectiveUserId.
string
Requires resourceId or perspectiveUserId. User perspectives use created_at order and exclude time bounds and platform filters.
string (date-time)
Exclusive upper bound on updatedAt, RFC 3339. Cannot combine with createdAt bounds.
string (date-time)
Inclusive lower bound on updatedAt, RFC 3339. Cannot combine with createdAt bounds.
"day"
Calendar-day counts by Message.createdAt
string
IANA zone for calendar-day buckets; defaults to UTC; requires interval

Returns

200 Matching Message count, optional direction groups and daily buckets CountMessagesResponse One of: MessageCount
integer
required
array of MessageStatusCount
required
One of: DailyMessageCount
array of MessageCountBucket
required
integer
required
array of MessageStatusCount
required
"day"
required
string
required