Skip to main content
GET
List conversations
Required scope: CONVERSATIONS_READ
This endpoint is paginated. Use page and size query parameters to control results. See Pagination.

Field notes

Extend parameter

The extend 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

Authorization
string
header
required

Query Parameters

allo_number
string
required

Filter by Allo number (E.164). Required — list your numbers with GET /v2/api/numbers to find the right one.

Example:

"+14155550100"

last_activity_since
string<date-time>

Only return conversations with activity after this timestamp (ISO 8601). Ideal for incremental sync.

Example:

"2026-04-20T10:00:00Z"

unread
boolean
page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
size
integer
default:20

Results per page

Required range: 1 <= x <= 100
extend
string

Comma-separated optional fields. Supported: transcript

Example:

"transcript"

Response

List of conversations

data
object[]
pagination
object