---
title: "GET /list-contact-conversations/{contact_id}"
method: GET
path: "/list-contact-conversations/{contact_id}"
---

# GET /list-contact-conversations/{contact_id}

`GET /list-contact-conversations/{contact_id}`

## Request

- Base URL: `https://api.retellai.com`
- URL: `https://api.retellai.com/list-contact-conversations/{contact_id}`
- Auth: HTTP bearer

List a contact's conversations (inbound calls, outbound calls, and chats) merged into a single timeline, most recent first. Results are matched by the contact's phone number. Use the returned `pagination_key` to fetch the next page.

## Path parameters

- `contact_id` string, required

## Query parameters

- `limit` integer
- `pagination_key` string

## Response `200`

Merged list of the contact's conversations.

- ContactConversationListResponse
  - `pagination_key` string: Pagination key for the next page.
  - `has_more` boolean, required: Whether more results are available.
  - `items` ContactConversation[], required
    - union
      - ContactCall
        - `type` 'call', required
        - `call_id` string, required
        - `start_timestamp` number: Epoch milliseconds when the call started.
        - `duration_ms` number: Duration of the call in milliseconds.
        - `direction` 'inbound' | 'outbound': Direction of the call.
        - `disconnection_reason` string: Reason the call ended.
        - `summary` string: Post-call analysis summary.
        - `sentiment` 'Negative' | 'Positive' | 'Neutral' | 'Unknown': User sentiment from post-call analysis.
        - `successful` boolean: Whether the call was deemed successful by post-call analysis.
      - ContactChat
        - `type` 'chat', required
        - `chat_id` string, required
        - `start_timestamp` number: Epoch milliseconds when the chat started.
        - `duration_ms` number: Duration of the chat in milliseconds.
        - `direction` 'inbound' | 'outbound': Direction of the chat.
        - `disconnection_reason` string: Reason the chat ended.
        - `summary` string: Post-chat analysis summary.
        - `sentiment` 'Negative' | 'Positive' | 'Neutral' | 'Unknown': User sentiment from post-chat analysis.
        - `successful` boolean: Whether the chat was deemed successful by post-chat analysis.

## Other responses

- `401`: Unauthorized
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

- **2026-10-16** `ca41f0dbb297`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/retellai/apis/retell-sdk/changes/list-contact-conversations/:contact_id/get.md)

---

[API](https://skmtc.dev/retellai/apis/retell-sdk.md) - [All operations](https://skmtc.dev/retellai/apis/retell-sdk/llms.txt) - [OpenAPI document](https://skmtc.dev/retellai/apis/retell-sdk/revisions/e482acaa292c?raw)