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
| Field | Null when |
|---|---|
summary | SMS items, or calls where AI summary is not yet available |
duration | SMS items (only applies to calls) |
result | SMS items (only applies to calls) |
detected_outbound_voicemail | Inbound calls, SMS items, or outbound calls where no detection ran |
voicemail_left | Inbound calls, SMS items, or outbound calls where it was not determined |
recording_url | Recording disabled, call not answered, SMS items, or accounts sold under a white-label partner's brand |
recording_download_url | Accounts 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_at | Same as recording_download_url |
recording_duration | Recording disabled, call not answered, or SMS items |
transcript | Not requested via extend=transcript, or SMS items |
extracted_data | SMS items, or calls Allo has not analyzed (not transcribed, or analysis still running) |
data_collected | SMS items |
content | Call items (only applies to SMS) |
status | Call items (only applies to SMS) |
attachments | Call items. An SMS with no photo or file returns an empty array. |
page_count | Calls, 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.
Recording links
A call can carry two links to its recording:
recording_urlis 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: userecording_download_urlthere.recording_download_urldownloads the recording file with no Allo login, and stays valid for 48 hours, untilrecording_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
| Value | Effect |
|---|---|
transcript | Include full call transcripts |
Passing an unsupported value returns a 400 error with code UNSUPPORTED_EXTEND_VALUE.