---
title: "List conversations for a contact"
method: GET
path: "/contacts/{contact_id}/conversations"
tags: ["Contacts"]
---

# List conversations for a contact

`GET /contacts/{contact_id}/conversations`

## Request

- Base URL: `https://api.thrivedesk.com/v1`
- URL: `https://api.thrivedesk.com/v1/contacts/{contact_id}/conversations`
- Auth: HTTP bearer

List conversations for a contact.

## Path parameters

- `contact_id` string, required

## Query parameters

- `inbox_id` string
- `except` string
- `limit` integer

## Response `200`

Success.

- ContactConversationsResponse
  - `conversations` ContactConversationItem[], required
    - `id` string
    - `subject` string, nullable
    - `status` string
    - `type` string: Conversation channel (e.g. `Email`).
    - `excerpt` string, nullable
    - `inbox_id` string
    - `priority` string
    - `tags` ConversationTag[]
      - `id` string
      - `name` string
      - `color` string: Hex color in `#RRGGBB` form.
    - `last_message_by` string, nullable
    - `created_at` string, date-time
  - `total` integer, required

## Other responses

- `401`: Missing or invalid bearer token.
- `403`: Token is valid but does not include a required scope, or the user does not have access to the resource.
- `404`: Resource not found.
- `422`: Request body failed validation.
- `429`: Rate limit exceeded. The `Retry-After` header indicates how long to wait before retrying. See [Pagination and rate limits](/get-started/pagination) for the full rate-limit policy.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/thrivedesk/apis/thrivedesk-public-api.md) - [All operations](https://skmtc.dev/thrivedesk/apis/thrivedesk-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thrivedesk/apis/thrivedesk-public-api/revisions/dce9c632a018?raw)