v1
latestOpenAPI 3.0.32026-07-264955102.7 KBConversations
List conversations
Returns a paginated list of conversations grouped by contact phone number, sorted by most recent activity.
get/v2/api/conversations
Query parameters
allo_numberstring required
Example:+14155550100
Filter by Allo number (E.164). Required — list your numbers with GET /v2/api/numbers to find the right one.
last_activity_sincestring date-time
Example:2026-04-20T10:00:00Z
Only return conversations with activity after this timestamp (ISO 8601). Ideal for incremental sync.
unreadboolean
pageinteger
Page number (1-indexed)
sizeinteger
Results per page
extendstring
Example:transcript
Comma-separated optional fields. Supported: transcript
Response
List of conversations
Example response
{
"data": [
{
"contact_number": "+14155551234",
"contacts": [
{
"id": "cnt-abc123",
"name": "Sarah Johnson",
"company": {
"id": "com-xyz789",
"name": "Acme Corp"
},
"deals": [
{
"id": "dea-def456",
"name": "Enterprise Plan"
}
]
}
],
"last_item": {
"id": "cll-abc123",
"allo_number": "+14155550100",
"contact_number": "+14155551234",
"contacts": [
{
"id": "cnt-abc123",
"name": "Sarah Johnson",
"company": {
"id": "com-xyz789",
"name": "Acme Corp"
},
"deals": [
{
"id": "dea-def456",
"name": "Enterprise Plan"
}
]
}
],
"user": {
"id": "usr-abc123",
"name": "John",
"email": "john@acme.com"
}
}
}
]
}