# 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…

`POST /v2/api/conversations/items/batch`

<Note>
**Required scope:** `CONVERSATIONS_READ`
</Note>

## 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

| 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](/docs/conversations/get-item#recording-links).

`attachments` lists the photos and other files of an MMS, each with a `download_url` valid for 30 minutes. See [MMS attachments](/docs/conversations/get-item#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`.
