List conversations
The account’s conversations, newest activity first, paginated. Filters are a fixed allowlist and combine with AND — send only the ones you need. An invalid filter value is a 400 whose details array names each offending parameter and says what it accepts.
The date filters compare full ISO 8601 timestamps, never calendar days: *_after is inclusive (>=), *_before exclusive (<), so chaining windows never double-counts a conversation. per_page is clamped, never rejected — above 100 you get 100, non-positive falls back to 25.
The ordering is always last_activity_at descending; there is no sort parameter.
Authorizations
The id_token from POST /auth/v1/signin, sent as Authorization: Bearer <id_token>. Not the access_token — that one does not carry the identity Cloud Chat authorizes on.
Headers
Your Cloud Chat instance ID — an integer, fixed for your company, told at onboarding. The API overview explains how instances work, how to find yours, and the errors a wrong or missing value produces.
1
Path Parameters
Your Cloud Chat account. It has to be an account your token grants membership on, and it has to live on the instance in the cloudchat-instance header — the two travel together. Account numbers are only unique within an instance, so the same number is a different company on another instance. Usually a mismatched pair fails closed with a 401, because your user does not exist on the other instance — but if your identity happens to exist on both, the call succeeds against the other company's data, silently. Read it and you are looking at the wrong help center; write it and you have stored into the wrong account. Send the two values that were given to you together, and never try a number to see what answers.
1
Query Parameters
Keep only conversations in this status.
open, resolved, pending, snoozed, proactive Keep only conversations assigned to this agent, by the agent id.
7
Keep only conversations of this inbox. An inbox your token cannot see yields an empty page, not an error.
3
Keep only conversations assigned to this team.
2
Keep only conversations carrying this label, matched exactly.
"vip"
Keep only conversations created at or after this instant. ISO 8601; a date without a time reads as midnight UTC.
"2026-08-01T00:00:00Z"
Keep only conversations created strictly before this instant. Pair with created_after for a half-open range that never double-counts across windows.
"2026-08-01T00:00:00Z"
Keep only conversations whose last change was at or after this instant. This is the field to poll when you mirror conversations somewhere else.
"2026-08-01T00:00:00Z"
Keep only conversations whose last change was strictly before this instant.
"2026-08-01T00:00:00Z"
1-based page number. Anything below 1 — including a non-numeric value — is read as 1.
x >= 11
Results per page. Clamped, never rejected: above 100 you get 100, below 1 you get the default 25.
1 <= x <= 10025