# Read a conversation's messages

The messages of one conversation, in order, both directions. Read this before replying to or summarising a thread.

Access class: `workspace`.

## Endpoint

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

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| id | path | string | Yes |
| body | query | null | No |
| params | query | object | No |
| query | query | object | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "messages": [
    {
      "call": {
        "ai_summary": "string",
        "answered_at": "string",
        "duration_seconds": "string",
        "ended_at": "string",
        "provider": "string",
        "recording_count": "string",
        "recording_url": "string",
        "result": "string",
        "started_at": "string",
        "transcript": "string"
      },
      "content": "string",
      "content_html": "string",
      "conversation_id": 1,
      "delivered_at": "string",
      "delivery": {
        "attempts": "string",
        "claimed_at": "string",
        "claimed_by": "string",
        "error": "string",
        "next_attempt_at": "string",
        "settled_at": "string",
        "state": "string"
      },
      "direction": "string",
      "external_id": "",
      "id": 1,
      "is_deleted": true,
      "medium": "string",
      "occurred_at": "string",
      "parent_message_id": 1,
      "read_at": "string",
      "recorded_at": "string",
      "sender_id": 1,
      "sender_name": "string",
      "sender_type": "string",
      "status": "string",
      "subject": "string",
      "text": {
        "error_code": "string",
        "error_message": "string",
        "media_count": "string",
        "provider": "string",
        "segment_count": "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"
}
```