List messages

Get a paginated list of the organization’s messages across all conversations, most recently created first. Supports filtering by from (the sender, equality), to (the exact recipient set, via a bare value or a comma-separated to[all] list), status, direction, phoneNumberId, userId, and a createdAt date range.

GET /messages

List messages

cURL

curl --request GET \
  --url https://dev-public-api.openphone.dev/messages \
  --header 'Authorization: <api-key>' \
  --header 'Quo-Api-Version: <quo-api-version>'

200

{
  "data": [
    {
      "id": "AC123abc",
      "to": [
        "[phone]"
      ],
      "from": "[phone]",
      "text": "Hello, world!",
      "conversationId": "CN123abc",
      "direction": "incoming",
      "status": "sent",
      "createdAt": "2022-01-01T00:00:00Z",
      "updatedAt": "2022-01-01T00:00:00Z",
      "media": [
        {
          "url": "https://example.com/image.png",
          "type": "image/png"
        }
      ],
      "phoneNumberId": "PN123abc",
      "userId": "US123abc"
    }
  ],
  "nextCursor": "eyJsYXN0SWQiOiJVU211a09NaXBhIn0"
}

Authorizations

Authorization · string · header · required

Headers

Quo-Api-Version · enum<string> · required

API version header. Supported values: 2026-03-30

Available options: 2026-03-30

Query Parameters

from · Option 1 · string Option 2 · string Option 3 · string

A phone number in E.164 format, a short code (3-8 digits), or a non-phone-number caller ID (Anonymous, Restricted, or Blocked).

Pattern: ^\+[1-9]\d{1,14}$

Example:

"[phone]"

to · Option 1 · string Option 2 · string Option 3 · string Option 4 · object

A phone number in E.164 format, a short code (3-8 digits), or a non-phone-number caller ID (Anonymous, Restricted, or Blocked).

Pattern: ^\+[1-9]\d{1,14}$

Example:

"[phone]"

status · enum<string> | null

The status of the message.

Available options: queued, sent, delivered, undelivered, received, failed

Example:

"sent"

direction · enum<string> | null

The direction of the message relative to the Quo number.

Available options: incoming, outgoing

Example:

"incoming"

phoneNumberId · string | null

Pattern: ^PN(.*)$

userId · string | null

Pattern: ^US(.*)$

createdAt · object | null

Show child attributes

limit · integer · default: 10

Max number of items to return per page.

Required range: 1 <= x <= 50

after · string

Example:

"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"

Response

200

application/json

OK

data · object[] · required

Show child attributes

nextCursor · string | null · required

Cursor for the next page, or null when there are no more pages.

Example:

"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"