Messages

List messages

List messages across the workspace, newest first. Both filters are optional, on purpose.

GET/v1/messages

Needs the messages:read scope.

Query parameters

limitinteger

1–100, default 25.

cursorstring

The `nextCursor` from a previous response.

numberIdstring

Narrow to one of the workspace's numbers.

participantstring

Narrow to messages to or from one E.164 number.

idsstring

Fetch specific items by id, comma separated, up to 100. Overrides paging and filters when given.

Returns

A page of messages. The items are in data, and nextCursor fetches the next page. A failed call answers with an error instead.

idstring

createdAtstring

directionstring

inbound | outbound.

fromstring

mediaMediaResource[]

numberIdstring

statusstring

textstring

tostring

curl https://api.ringhouse.ai/v1/messages \
  -H "Authorization: Bearer rh_live_xxxxxxxx"

{
  "data": [
    {
      "id": "4b1a8d2e-6c3f-47b9-8e05-d91a2c7f6b34",
      "createdAt": "2026-09-25T14:02:11Z",
      "direction": "inbound",
      "from": "+447700900123",
      "media": [
        {
          "contentType": "image/jpeg",
          "url": "https://files.ringhouse.ai/media/8c1d4e7a/photo.jpg"
        }
      ],
      "numberId": "3f9c1a2e-7b4d-4c8e-9a1f-5d2e8b6c0a41",
      "status": "completed",
      "text": "Is my table ready for eight?",
      "to": "+441134960000"
    }
  ],
  "nextCursor": "MjAyNi0wOS0yNVQxNDowMjoxMVp8M2Y5YzFhMmU"
}

Was this page helpful?

Previous← Webhooks NextSend a message