Skip to main content
POST
/
v2
/
api
/
conversations
/
items
/
batch
Get many conversation items
curl --request POST \
  --url https://api.withallo.com/v2/api/conversations/items/batch \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "cll-abc123",
    "cll-def456",
    "cll-ghi789"
  ]
}
'
{
  "data": [
    {
      "id": "cll-abc123",
      "type": "CALL",
      "direction": "INBOUND",
      "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",
              "status": "OPEN"
            }
          ]
        }
      ],
      "user": {
        "id": "usr-abc123",
        "name": "John",
        "email": "[email protected]"
      },
      "date": "2023-11-07T05:31:56Z",
      "duration": 123,
      "result": "ANSWERED",
      "recording_url": "<string>",
      "summary": "<string>",
      "tags": [
        "<string>"
      ],
      "transcript": [
        {
          "source": "USER",
          "time": "2023-11-07T05:31:56Z",
          "text": "<string>"
        }
      ],
      "content": "<string>",
      "status": "PENDING",
      "message_type": "SMS"
    }
  ]
}

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.

Required scope: CONVERSATIONS_READ

Limits

  • Maximum 100 items per batch request
  • Exceeding this returns a 400 error with code BATCH_TOO_LARGE

Item ID format

  • Call IDs start with cll- (e.g., cll-abc123)
  • Message IDs start with msg- (e.g., msg-def456)
Items that don’t exist are silently omitted from the response.

Field notes

FieldNull when
summarySMS items, or calls where AI summary is not yet available
durationSMS items (only applies to calls)
resultSMS items (only applies to calls)
recording_urlRecording disabled, call not answered, or SMS items
transcriptNot requested via extend=transcript, or SMS items
contentCall items (only applies to SMS)
statusCall items (only applies to SMS)

Extend parameter

ValueEffect
transcriptInclude full call transcripts for all call items in the batch
Passing an unsupported value returns a 400 error with code UNSUPPORTED_EXTEND_VALUE.

Authorizations

Authorization
string
header
required

Body

application/json
ids
string[]
required

Array of conversation item IDs (max 100)

Maximum array length: 100

Response

Conversation items

data
object[]