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
| Field | Null when |
|---|---|
last_item.summary | SMS items, or calls where AI summary is not yet available |
last_item.duration | SMS items (only applies to calls) |
last_item.result | SMS items (only applies to calls) |
last_item.recording_url | Recording disabled, call not answered, or SMS items |
last_item.transcript | Not requested via extend=transcript, or SMS items |
last_item.content | Call items (only applies to SMS) |
last_item.status | Call items (only applies to SMS) |
last_item.contacts | Empty array when no matching contact exists in the address book |
Extend parameter
Theextend query parameter accepts a comma-separated list of optional fields to include. Currently supported:
| Value | Effect |
|---|---|
transcript | Include full call transcripts on conversation items |
400 error with code UNSUPPORTED_EXTEND_VALUE.Authorizations
Query Parameters
Filter by Allo number (E.164)
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"