Get many conversation items
Conversations
Get many conversation items
Returns multiple conversation items by their IDs in a single request. Use this to fetch full details (summary, tags, recording, etc.) for items returned by the analytics drilldown or any other list.
POST
Get many conversation items
Required scope:
CONVERSATIONS_READLimits
- 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)
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) |
recording_url | 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) |
Extend parameter
| Value | Effect |
|---|---|
transcript | Include full call transcripts for all call items in the batch |
400 error with code UNSUPPORTED_EXTEND_VALUE.