Skip to main content
GET
Get conversation item
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

duration is the total call length in seconds, ringing included. 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 duration. A call can carry two links to its recording:
  • recording_url is Allo’s own link to the recording, which opens an Allo-branded page for anyone not signed in to Allo. For that reason it is absent on accounts sold under a white-label partner’s brand: use recording_download_url there.
  • recording_download_url downloads the recording file with no Allo login, and stays valid for 48 hours, until recording_download_expires_at. Allo returns it only on lines of accounts created by a partner, and only when the key’s user can play the recording. Allo never returns it for a call on a HIPAA-enabled team.
For a fresh link valid for 60 minutes, call Get recording download link.

Result values

result is one of ANSWERED, VOICEMAIL, TRANSFERRED_AI, TRANSFERRED_EXTERNAL, BLOCKED, FAILED, FAILED_EXTERNAL, RECEIVED or CLOSED. They mean the same as in the call.completed webhook. Handle unknown values gracefully: new outcomes may be added.

Extracted data

After a call is transcribed, Allo’s AI reads the conversation and picks up the contact details the other side gave. extracted_data holds them:
A detail nobody mentioned is an empty string, or an empty emails list. These values are what the AI heard: check them before you write them to your CRM. extracted_data is set once per call and does not change when a summary is edited. data_collected is a legacy field kept for compatibility. It is an empty object on current calls.

Extend parameter

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