Passer au contenu principal
GET
List conversations
Scope requis : CONVERSATIONS_READ
Cet endpoint est paginé. Utilisez les paramètres de requête page et size pour contrôler les résultats. Voir Pagination.

Notes sur les champs

Paramètre extend

Le paramètre de requête extend accepte une liste de champs optionnels séparés par des virgules. Actuellement pris en charge : Passer une valeur non prise en charge renvoie une erreur 400 avec le code UNSUPPORTED_EXTEND_VALUE.

Autorisations

Authorization
string
header
requis

Paramètres de requête

allo_number
string
requis

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

Exemple:

"+14155550100"

last_activity_since
string<date-time>

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

Exemple:

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

unread
boolean
page
integer
défaut:1

Page number (1-indexed)

Plage requise: x >= 1
size
integer
défaut:20

Results per page

Plage requise: 1 <= x <= 100
extend
string

Comma-separated optional fields. Supported: transcript

Exemple:

"transcript"

Réponse

List of conversations

data
object[]
pagination
object