---
title: "List RCS messages"
method: GET
path: "/v2/rcs/messages"
tags: ["RCS"]
---

# List RCS messages

`GET /v2/rcs/messages`

Retrieves a list of RCS messages for your account with flexible date filtering.

Messages are returned in reverse chronological order (newest first).

**Date Filtering:**
- Preset ranges (last_week, last_thirty, last_month): Calculated using your account timezone
- Custom date ranges: Use RFC3339 timestamps (max 90 days)
- The 'all' option provides up to 365 days of history
- All timestamps in responses are returned in UTC format

**Pagination:**
- Cursor-based pagination for efficient data retrieval
- Control page size with the limit parameter (1-100 messages per page)

## Query parameters

- `date_range` 'last_week' | 'last_thirty' | 'last_month' | 'all' | 'custom_date'
- `start_date` string
- `end_date` string
- `limit` integer
- `cursor` string
- `direction` 'next' | 'prev'

## Response `200`

OK

- object
  - `data` object, required — Container for the list of RCS messages.
    - `messages` RcsListMessageItem[], required — Array of RCS messages.
      - `id` string, required — Unique identifier for the message.
      - `message_ref` string — Optional reference ID set by the user for the message.
      - `sender` string, required — Registered RCS Agent ID.
      - `recipient` string, phone, required — RCS recipient phone number in international format.
      - `content_type` 'text', required — Type of the message content.
      - `content` object, required — Content details for the message.
        - `text` RCSText, required — Text content for the message.
          - `message` string, required — The text message body. **Message Types:** - **Basic RCS Messages**: Up to 160 characters (SMS format in RCS) - **Simple RCS Messages**: Up to 3072 characters with emoji and UTF-8 support
      - `status` 'QUEUED' | 'SENT' | 'DELIVERED' | 'READ' | 'FAILED', required — Current status of an RCS message.
      - `created_at` string, date-time, required — Timestamp in RFC3339 format (e.g., 2025-08-26T10:30:00Z) when the message was created on the server.
  - `request` object — Optional metadata (e.g. requestId, traceId)
  - `meta` object — Metadata for the list messages response including pagination details.
    - `pagination` PaginationMeta, required — Pagination metadata for cursor-based pagination. Reusable across all paginated API endpoints.
      - `type` 'cursor', required — The pagination strategy being used.
      - `next_cursor` string, nullable — Cursor to fetch the next page of results. Omitted if there are no more results.
      - `prev_cursor` string, nullable — Cursor to fetch the previous page of results. Omitted if on the first page.
      - `has_next` boolean, required — Indicates whether there are more results available after the current page.
      - `has_prev` boolean, required — Indicates whether there are results available before the current page.

## Other responses

- `400` — Input Validation Error
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/kudosity/apis/transmit-sms-api.md) · [All operations](https://skmtc.net/kudosity/apis/transmit-sms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kudosity/transmit-sms-api/revisions/9f6c34b849af/schema)