# Get conversation item

> Returns a single call or SMS message by its ID.

`GET /v2/api/conversations/items/{id}`

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

## 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_url` is 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: use `recording_download_url` there.
- `recording_download_url` downloads the recording file with no Allo login, and stays valid for 48 hours, until `recording_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](/docs/conversations/get-item-recording).

### MMS attachments

`attachments` lists the photos and other files sent with a message, in the order they were sent:

```json
"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](/docs/fax/send-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](/docs/webhooks/event-catalog#call-result-values). 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:

```json
"extracted_data": {
  "contact": {
    "name": "Marie Dupont",
    "company": "Vibrant Events",
    "job_title": "Office manager",
    "website": "vibrantevents.com",
    "address": "12 rue de la Paix, Paris",
    "emails": ["marie@vibrantevents.com"]
  }
}
```

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`.
