Skip to main content
POST
Get many conversation items
Required scope: CONVERSATIONS_READ

Limits

  • Maximum 100 items per batch request
  • Exceeding this returns a 400 error with code BATCH_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

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.

Extend parameter

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

Authorizations

Authorization
string
header
required

Body

application/json
ids
string[]
required

Array of conversation item IDs (max 100)

Maximum array length: 100

Response

Conversation items

data
object[]