Passer au contenu principal
GET
/
v2
/
api
/
conversations
List conversations
curl --request GET \
  --url https://api.withallo.com/v2/api/conversations \
  --header 'Authorization: <api-key>'
{
  "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",
              "status": "open"
            }
          ]
        }
      ],
      "last_activity": "2026-04-21T14:30:00Z",
      "last_item": {
        "id": "cll-abc123",
        "type": "CALL",
        "direction": "INBOUND",
        "date": "2026-04-21T14:30:00Z",
        "summary": "Customer called about upgrading their plan.",
        "result": "ANSWERED",
        "duration": 145
      }
    }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "total_count": 156,
    "total_pages": 8,
    "has_more": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://help.withallo.com/llms.txt

Use this file to discover all available pages before exploring further.

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

ChampNull quand
last_item.summaryÉléments SMS, ou appels dont le résumé IA n’est pas encore disponible
last_item.durationÉléments SMS (s’applique uniquement aux appels)
last_item.resultÉléments SMS (s’applique uniquement aux appels)
last_item.recording_urlEnregistrement désactivé, appel sans réponse, ou éléments SMS
last_item.transcriptNon demandé via extend=transcript, ou éléments SMS
last_item.contentÉléments d’appel (s’applique uniquement aux SMS)
last_item.statusÉléments d’appel (s’applique uniquement aux SMS)
last_item.contactsTableau vide lorsqu’aucun contact correspondant n’existe dans le carnet d’adresses

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 :
ValeurEffet
transcriptInclure les transcriptions complètes des appels sur les éléments de conversation
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

Filter by Allo number (E.164)

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