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

# List Chat Messages

> Read a visitor's conversation with an agent, and whether a reply is coming

Returns the visitor's messages and the agent's replies, oldest first. Poll it after [sending a message](https://docs.telzino.com/api-reference/chat/send.md) until `pending` is `false`. About once a second is right; the [Chat SDK](https://docs.telzino.com/sdk/chat.md) does this for you and slows down after errors.

Same publishable key and origin rules as [Send Chat Message](https://docs.telzino.com/api-reference/chat/send.md).

## Query Parameters

**agent\_id** `string (UUID)` *required*

The agent

**visitor\_id** `string` *required*

The visitor id used when sending

**after** `string (date-time)`

Only messages created after this time, up to 100. Without it, the newest 100 messages.

```bash cURL theme={null}
curl "https://api.telzino.com/v1/chat/messages?agent_id=3f1c2a4e-8b7d-4c3a-9e2f-1a2b3c4d5e6f&visitor_id=v_9b1c5f3e2d1a0b9c" \
  -H "Authorization: Bearer pk_live_..." \
  -H "Origin: https://example.com"
```

```json 200 theme={null}
{
  "messages": [
    { "id": "6d0c8b8e-...", "role": "user", "text": "Do you open on Sunday?", "created_at": "2026-11-12T10:00:00Z" },
    { "id": "1a2b3c4d-...", "role": "agent", "text": "Yes, from 10am to 4pm.", "created_at": "2026-11-12T10:00:03Z" }
  ],
  "pending": false
}
```

## Response

**messages** `array`

`id`, `role` (`user` for the visitor, `agent` for the agent), `text`, `created_at`

**pending** `boolean`

`true` while the agent is still working on a reply

> [!NOTE]
>
> A reply's `created_at` is when the agent started sending it, so it can be earlier than a message the visitor sent meanwhile. When polling with `after`, go back a couple of minutes from the newest message you have and skip ids you already showed. The SDK does this.

## Errors

Same as [Send Chat Message](https://docs.telzino.com/api-reference/chat/send.md). Polling is limited to 120 requests per minute per visitor.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.