Get threads
Authorizations
JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer
Query Parameters
Channel to list conversations for. EMAIL is currently the only supported value — SMS/MMS conversations are listed by GET /sms/threads, which models them as a phone-number pair rather than a reply chain.
EMAIL Filter conversations to one agent. Optional for master keys (omit for every agent in the org); ignored for agent keys, which always see only their own.
^[cC][^\s-]{8,}$Filter conversations to one inbox — the precise way to read a single mailbox.
^[cC][^\s-]{8,}$Only conversations containing a message in this direction. OUTBOUND is a Sent view. Note that the returned counts then describe the MATCHING messages, not the thread's full length.
INBOUND, OUTBOUND Filter to messages carrying ALL of these labels (e.g. urgent + unread means urgent AND still unread). Case-insensitive. System labels: unread, read, archived, spam.
501 - 64Include messages classified as spam on arrival. They are excluded by default. Naming spam in labels also counts as asking for it, so a deliberate spam query is never silently emptied by this default.
Include messages carrying the archived label. They are excluded by default, so archiving actually removes mail from a listing rather than only tagging it. Naming archived in labels also counts as asking for it (and returns ONLY archived mail); use this flag instead to see archived mail mixed in with the rest.
How to treat messages moved to Trash. exclude (default) hides them, so deleted mail disappears from every ordinary listing. only returns nothing but Trash. include ignores the distinction. Deletion is reversible — see DELETE /messages/{id} and POST /messages/{id}/restore.
exclude, include, only Maximum conversations to return per page (1–100, default 20)
1 <= x <= 100Conversations to skip, for paging through the list
x >= 0