List conversations
GET/conversations
Conversations in one status bucket, filtered and paginated.
status defaults to open, which also folds in missed — a missed call is an
open conversation nobody has picked up, not a separate queue.
Filters combine with AND; repeated values within one filter combine with OR, and
may be sent either repeated (?label=vip&label=urgent) or comma-separated
(?label=vip,urgent). Two filters take sentinel values:
assignee_id=unassigned finds the waiting line, and team_id=none finds
conversations no team owns.
Fetching a large status=resolved set? Add created_after / created_before.
Open buckets stay small; the resolved archive does not.
Request
Responses
- 200
- 400
- 401
- 403
- 503
Conversations returned.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
The request was malformed, or a parameter was rejected.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
No token, an expired token, or a credential that has been revoked.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
Refused. Either the credential does not hold the scope this endpoint needs (code: insufficient_scope), or the account's IP allow-list does not include the calling address (code: ip_not_allowed).
Response Headers
Correlation id for this request. Quote it when reporting a problem.
A dependency is temporarily unavailable, or a required index is still building. Safe to retry.
Response Headers
Correlation id for this request. Quote it when reporting a problem.