---
title: "List messages"
method: GET
path: "/v1/messages"
tags: ["Messages"]
---

# List messages

`GET /v1/messages`

## Request

- Base URL: `https://www.chatrail.dev`
- URL: `https://www.chatrail.dev/v1/messages`
- Auth: HTTP bearer

Newest first, cursor paginated. Offsets are not offered: they skip and duplicate.

## Query parameters

- `limit` integer
- `cursor` string
- `connection` string
- `status` 'scheduled' | 'accepted' | 'queued' | 'submitting' | 'submitted' | 'sent' | 'delivered' | 'read' | 'failed' | 'canceled'
- `direction` 'inbound' | 'outbound'

## Response `200`

A page of messages and a `next_cursor`.

---

[API](https://skmtc.dev/chatrail/apis/chatrail-api.md) · [All operations](https://skmtc.dev/chatrail/apis/chatrail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatrail/apis/chatrail-api/revisions/acc5b88c6f59?raw)