# Read one conversation

One conversation by its id, exactly as the inbox lists it: the other side (`contact_identifier`, `contact_name`), our line it is on (`account_identifier`), the medium, the records it is filed under, whether it is unread and its last word. Reach for this to know who a thread is with and which line answers it; its messages are `get_comms_conversations_id_messages`. Another workspace's conversation, or a private one the caller is not on, is a 404.

Access class: `workspace`.

## Endpoint

`GET /v1/comms/conversations/{id}`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| id | path | string | Yes |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "account_identifier": "string",
  "contact_identifier": "string",
  "contact_name": "string",
  "contact_role": "string",
  "created_at": "2026-01-01T00:00:00Z",
  "id": 1,
  "is_archived": true,
  "is_muted": true,
  "is_pinned": true,
  "is_starred": true,
  "labels": [
    {
      "id": "",
      "name": "string",
      "tone": "string"
    }
  ],
  "last_message_at": "2026-01-01T00:00:00Z",
  "last_message_direction": "string",
  "last_message_preview": "string",
  "medium": "string",
  "messages": [
    {
      "call": "string",
      "content": "string",
      "content_html": "string",
      "conversation_id": "",
      "delivered_at": "string",
      "delivery": "string",
      "direction": "string",
      "external_id": "",
      "id": "",
      "is_deleted": "string",
      "medium": "string",
      "occurred_at": "string",
      "parent_message_id": "",
      "read_at": "string",
      "recorded_at": "string",
      "sender_id": "",
      "sender_name": "string",
      "sender_type": "string",
      "status": "string",
      "subject": "string",
      "text": "string"
    }
  ],
  "ownerAccountId": "",
  "records": [
    {
      "definition_id": "",
      "definition_key": "string",
      "linked_at": "string",
      "name": "string",
      "row_id": "",
      "status": "string",
      "status_label": "string",
      "status_tone": "string"
    }
  ],
  "subject": "string",
  "unread_count": 1,
  "visibility": "string"
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
