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.

Line or inbox

Send exactly one of allo_number or inbox_id. Sending both, or neither, returns 400 with code INVALID_REQUEST.
  • allo_number lists the conversations of one Allo line. A line the caller cannot access returns 403 with code ALLO_NUMBER_FORBIDDEN.
  • inbox_id lists the conversations of one of your inboxes, with conversations from several lines (each row has one allo_number). The inbox’s saved sources and filters apply, but not the app’s Needs action and Mine tabs. “Unread only” is not saved on an inbox: pass the unread query parameter. An inbox that is not yours returns 404 with code INBOX_NOT_FOUND.
Each conversation has an allo_number field, the Allo line it is on. Use it to pin or reply when listing by inbox.

Inbox and pinned errors

Pinned conversations

Each conversation has a pinned field. Pass pinned=true to list only pinned conversations, or pinned=false to leave them out. Pin and unpin with Pin conversation and Unpin conversation.

Field notes

last_item.duration is the total call length in seconds, ringing included. last_item.recording_duration is the talk time, which is what the Allo app displays for recorded calls. For calls without a recording, the app falls back to last_item.duration.

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

Filter by Allo number (E.164). Send exactly one of allo_number or inbox_id. List your numbers with GET /v2/api/numbers to find the right one.

Example:

"+14155550100"

inbox_id
string

List the conversations of one of your inboxes (inb-*), from all of its lines (each row has its own allo_number). The inbox's sources and saved filters apply, but not the app's Needs action and Mine tabs; pass unread yourself. Send exactly one of allo_number or inbox_id.

Example:

"inb-abc123"

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
pinned
boolean

Only pinned (true) or only unpinned (false) conversations. Any other value returns 400 INVALID_PARAMETER.

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