List conversations
Conversations
List conversations
Returns a paginated list of conversations grouped by contact phone number, sorted by most recent activity.
GET
List conversations
Required scope:
CONVERSATIONS_READpage and size query parameters to control results. See Pagination.
Field notes
Extend parameter
Theextend query parameter accepts a comma-separated list of optional fields to include. Currently supported:
Passing an unsupported value returns a
400 error with code UNSUPPORTED_EXTEND_VALUE.Authorizations
Query Parameters
Filter by Allo number (E.164). Required — list your numbers with GET /v2/api/numbers to find the right one.
Example:
"+14155550100"
Only return conversations with activity after this timestamp (ISO 8601). Ideal for incremental sync.
Example:
"2026-04-20T10:00:00Z"
Page number (1-indexed)
Required range:
x >= 1Results per page
Required range:
1 <= x <= 100Comma-separated optional fields. Supported: transcript
Example:
"transcript"