Limits
- Maximum 100 items per batch request
- Exceeding this returns a
400error with codeBATCH_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
| 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 |
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_download_url downloads the recording file with no Allo login, for 48 hours. It is returned only on lines of accounts created by a partner, never for a HIPAA call. See Recording links.
attachments lists the photos and other files of an MMS, each with a download_url valid for 30 minutes. See MMS attachments.
Extend parameter
| Value | Effect |
|---|---|
transcript | Include full call transcripts for all call items in the batch |
Passing an unsupported value returns a 400 error with code UNSUPPORTED_EXTEND_VALUE.