Allo

Get conversation item

Returns a single call or SMS message by its ID.

GET/v2/api/conversations/items/{id}

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)
detected_outbound_voicemailInbound calls, SMS items, or outbound calls where no detection ran
voicemail_leftInbound calls, SMS items, or outbound calls where it was not determined
recording_urlRecording disabled, call not answered, SMS items, or accounts sold under a white-label partner's brand
recording_download_urlAccounts not created by a partner, calls on a HIPAA-enabled team, calls without a recording, a key user who cannot play the recording, or SMS items
recording_download_expires_atSame as recording_download_url
recording_durationRecording disabled, call not answered, or SMS items
transcriptNot requested via extend=transcript, or SMS items
extracted_dataSMS items, or calls Allo has not analyzed (not transcribed, or analysis still running)
data_collectedSMS items
contentCall items (only applies to SMS)
statusCall items (only applies to SMS)
attachmentsCall items. An SMS with no photo or file returns an empty array.
page_countCalls, messages that are not faxes, or a fax whose page count is not known yet

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.

MMS attachments

attachments lists the photos and other files sent with a message, in the order they were sent:

"attachments": [
  {
    "file_name": "IMG_0412.jpg",
    "content_type": "image/jpeg",
    "file_size": 245760,
    "download_url": "https://...IMG_0412.jpg?X-Amz-Expires=1800&X-Amz-Signature=...",
    "download_expires_at": "2026-11-05T14:30:00Z"
  }
]

download_url downloads the file with no Allo login, and stays valid for 30 minutes, until download_expires_at. Save the file rather than the link. For a fresh link, fetch the item again: every response signs a new one.

download_url and download_expires_at are null for a message on a HIPAA-enabled team, or when Allo could not sign the link. The file name, type and size are still returned.

Faxes

A fax is an item of type SMS with message_type FAX. attachments holds the faxed PDF, and page_count its number of pages. page_count is null until the page count is known, for example right after you send a fax.

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:

"extracted_data": {
  "contact": {
    "name": "Marie Dupont",
    "company": "Vibrant Events",
    "job_title": "Office manager",
    "website": "vibrantevents.com",
    "address": "12 rue de la Paix, Paris",
    "emails": ["[email protected]"]
  }
}

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

ValueEffect
transcriptInclude full call transcripts

Passing an unsupported value returns a 400 error with code UNSUPPORTED_EXTEND_VALUE.

Authorization

Authorizationstring · headerrequired

Api-Key ak_live_…

Path parameters

idstringrequired

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

Query parameters

extendstring

Comma-separated optional fields. Supported: transcript

Responses

200Conversation item
dataobject
26 fields
idstring
typeenum<string>

CALL for a call, SMS for a message. Faxes are SMS items with message_type set to FAX.

CALLSMS

directionenum<string>

INBOUNDOUTBOUND

allo_numberstring
contact_numberstring
contactsobject[]
4 fields
idstring
namestring
companyobject | null
2 fields
idstring
namestring
dealsobject[]
3 fields
idstring
namestring
statusenum<string>

OPENWONLOST

userobject
3 fields
idstring
namestring
emailstring
datestring<date-time>
durationinteger | null

Total call length in seconds, from when the call starts (ringing included) to when it ends. For the talk time shown in the Allo app, use recording_duration.

resultenum<string>

Call outcome. Null for SMS items. An outbound call that reached voicemail reports VOICEMAIL. FAILED_EXTERNAL only appears on older calls. New values may be added: handle unknown values gracefully.

ANSWEREDVOICEMAILTRANSFERRED_AITRANSFERRED_EXTERNALBLOCKEDFAILEDFAILED_EXTERNALRECEIVEDCLOSED

detected_outbound_voicemailboolean | null

Outbound calls only. true when the call was answered by an answering machine, false when a human answered, null when no detection ran for this call (never set on inbound calls or SMS). Note that result stays ANSWERED for these calls — the carrier considers a machine pickup an answer.

voicemail_leftboolean | null

Outbound calls only. true when a message was actually left on the voicemail, false when the caller hung up without leaving one, null when not determined. Independent of detected_outbound_voicemail: either can be set without the other.

recording_urlstring | null

Link to the call recording. Absent when the call was not recorded, and for accounts sold under a white-label partner's brand: use recording_download_url there.

recording_download_urlstring | null

Signed link that downloads the recording with no login, valid for 48 hours. Returned only for lines of accounts created by a partner, never for a call on a HIPAA-enabled team, and only when the key's user can play the recording. For a fresh link, call GET /v2/api/conversations/items/{id}/recording.

recording_download_expires_atstring<date-time> | null

When recording_download_url stops working.

recording_durationinteger | null

Length of the call recording in seconds: the talk time, excluding ringing. This is the duration shown in the Allo app for recorded calls. null when the call was not recorded.

summarystring | null
tagsstring[]
extracted_dataobject | null

Contact details Allo's AI picked up from the call transcript, under a contact object: name, company, job_title, website, address (strings, empty when not mentioned) and emails (array). Null for SMS items and for calls Allo has not analyzed.

1 fields
contactobject
6 fields
namestring
companystring
job_titlestring
websitestring
addressstring
emailsstring[]
data_collectedobject | null

Legacy field kept for compatibility. An empty object on current calls. Null for SMS items.

transcriptobject[]
3 fields
sourceenum<string>

USEREXTERNAL

timestring<date-time>
textstring
contentstring | null
statusenum<string>

PENDINGSENTDELIVEREDFAILED

message_typeenum<string>

SMSMMSWHATSAPPFAX

attachmentsobject[]

Photos and other files sent with the message, in the order they were sent. For a fax, the faxed PDF. An empty array for a message with no files, and null for a call.

5 fields
file_namestring
content_typestring

MIME type of the file.

file_sizeinteger<int64> | null

Size of the file in bytes.

download_urlstring | null

Signed link that downloads the file with no login, valid for 30 minutes. null for a message on a HIPAA-enabled team. For a fresh link, fetch the item again.

download_expires_atstring<date-time> | null

When download_url stops working.

page_countinteger | null

Number of pages of a fax. null for calls, for messages that are not faxes, and for a fax whose page count is not known yet.

401
404
429