---
title: "View a conversation"
method: GET
path: "/conversation/{conversation_id}"
tags: ["Conversations"]
---

# View a conversation

`GET /conversation/{conversation_id}`

## Request

- Base URL: `https://api.thrivedesk.com/v1`
- URL: `https://api.thrivedesk.com/v1/conversation/{conversation_id}`
- Auth: HTTP bearer

View a conversation.

## Path parameters

- `conversation_id` string, required

## Response `200`

Success.

- ConversationView
  - `conversation` ConversationDetail: A conversation (ticket) as returned in list responses (`GET /v1/conversations/mine`, `GET /v1/inboxes/{inbox_id}`).
    - `id` string
    - `inbox_id` string
    - `ticket_id` integer
    - `has_attachment` boolean
    - `has_inline_attachment` boolean
    - `is_draft` boolean
    - `is_scheduled` boolean
    - `is_snoozed` boolean
    - `active` boolean
    - `subject` string, nullable
    - `updated_subject` string, nullable
    - `status` 'Active' | 'Pending' | 'Closed'
    - `is_spam` boolean
    - `priority` 'High' | 'Medium' | 'Low'
    - `assignable_type` string, nullable: Polymorphic type of the assignee (a user or a team).
    - `assignable_id` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `deleted_at` string, date-time, nullable
    - `closed_at` string, date-time, nullable
    - `excerpt` string, nullable
    - `messages_count` integer, nullable
    - `last_message_created_at` string, date-time, nullable
    - `intended_inbox_address_id` string, nullable
    - `agents` string[]: IDs of agents assigned to the conversation.
    - `contact` Contact: A person who sends or receives messages.
      - `id` string
      - `name` string, nullable
      - `email` string, email
      - `avatar` string, uri, nullable
      - `company` string, nullable
      - `website` string, nullable
      - `job_title` string, nullable
      - `address` string, nullable
      - `should_display_image` boolean
      - `notes` string, nullable
      - `conversations_count` integer
    - `last_message` ConversationLastMessage: A compact view of the most recent message on a conversation.
      - `id` string
      - `cc` string[], nullable
      - `bcc` string[], nullable
      - `record_type` string
      - `status` string
      - `direction` string
      - `viewed_at` string, date-time, nullable
      - `created_at` string, date-time
      - `text_body` string, nullable
      - `excerpt` string, nullable
      - `html_body` string, nullable
      - `extra` object: Additional message metadata (free-form).
      - `is_clipped` boolean
      - `intended_inbox_address_id` string, nullable
    - `custom_field_values` object: Custom-field values keyed by field key (free-form).
    - `viewer_id` string, nullable
    - `viewed_at` string, nullable
    - `last_message_by` string, nullable
    - `tags` ConversationTag[]
      - `id` string
      - `name` string
      - `color` string: Hex color in `#RRGGBB` form.
  - `events` object
    - `data` ThreadEvent[]
      - `id` string
      - `action` string: The kind of thread event (e.g. `started`, `conversation_contact_changed`).
      - `created_at` string, date-time
      - `event_id` string, nullable
      - `event_type` string, nullable: Polymorphic type of the linked event record, when present.
      - `event` Message: A full message record, embedded as the `event` of a message thread event.
        - `id` string
        - `cc` string[], nullable
        - `bcc` string[], nullable
        - `record_type` string
        - `status` string
        - `direction` string
        - `viewed_at` string, date-time, nullable
        - `created_at` string, date-time
        - `text_body` string, nullable
        - `excerpt` string, nullable
        - `html_body` string, nullable
        - `extra` object: Additional message metadata (free-form).
        - `downloadable_attachments` object[]: Attachments on the message, with direct and API download URLs.
          - `id` string
          - `name` string
          - `size` integer
          - `url` string, uri
          - `download_url` string, uri
        - `is_clipped` boolean
        - `intended_inbox_address_id` string, nullable
      - `actor_id` string, nullable
      - `actor_type` string, nullable: Polymorphic type of the actor (a user or a contact).
      - `actor` Actor: A compact identity (user or contact) that performed an action or authored content.
        - `id` string
        - `name` string, nullable
        - `email` string, email, nullable
        - `avatar` string, uri, nullable
      - `extra` object: Event-specific metadata that varies by action (free-form).
      - `conversation_id` string
    - `links` PaginationLinks
      - `first` string, uri, nullable
      - `last` string, uri, nullable
      - `prev` string, uri, nullable
      - `next` string, uri, nullable
    - `meta` PaginationMeta: Standard (counting) paginator meta block.
      - `current_page` integer
      - `from` integer, nullable
      - `last_page` integer
      - `per_page` integer
      - `to` integer, nullable
      - `total` integer
      - `path` string, uri
      - `links` object[]: Rendered paginator links: the numbered pages plus the previous/next controls (whose `url` and `page` are null when unavailable).
        - `url` string, uri, nullable
        - `label` string
        - `page` integer, nullable
        - `active` boolean

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