> ## Documentation Index
> Fetch the complete documentation index at: https://docs.osis.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List messages

> GET /api/v1/comms/messages — read message history on your line.

List messages for your workspace, optionally filtered to a conversation.

**Scope:** `comms_read`

## Request

```bash theme={null}
curl "https://osis.co/api/v1/comms/messages?limit=50" \
  -H "Authorization: Bearer $COMMS_API_KEY"
```

### Query parameters

<ParamField query="conversation_id" type="string">
  Only return messages in this conversation.
</ParamField>

<ParamField query="since" type="string">
  Lower bound timestamp (ISO-8601 when provided).
</ParamField>

<ParamField query="direction" type="string">
  Filter by message direction when supported by your deployment.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of messages to return. Must be a positive integer.
</ParamField>

## Response

```json theme={null}
{
  "messages": [
    {
      "id": "msg_…",
      "body": "Hello from Comms",
      "direction": "outbound"
    }
  ]
}
```

## Errors

| Status | Meaning              |
| ------ | -------------------- |
| 401    | Unauthorized         |
| 403    | Missing `comms_read` |
| 429    | Rate limited         |

## See also

* [Send a message](/messages-api/send-message)
* [List conversations](/messages-api/list-conversations)