Skip to main content
GET
/
v2
/
api
/
conversations
/
items
/
{id}
Get conversation item
curl --request GET \
  --url https://api.withallo.com/v2/api/conversations/items/{id} \
  --header 'Authorization: <api-key>'
{
  "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

​
Item ID format

  • Call IDs start with cll- (e.g., cll-abc123)
  • Message IDs start with msg- (e.g., msg-def456)
Passing an ID with an unrecognized prefix returns a 400 error with code INVALID_ITEM_ID.

​
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
Passing an unsupported value returns a 400 error with code UNSUPPORTED_EXTEND_VALUE.

Authorizations

​
Authorization
string
header
required

Path Parameters

​
id
string
required

Item ID (cll-* for calls, msg-* for messages)

Example:

"cll-abc123"

Query Parameters

​
extend
string

Comma-separated optional fields. Supported: transcript

Example:

"transcript"

Response

Conversation item

​
data
object