---
title: "List all Messages"
method: GET
path: "/Accounts/{AccountSid}/Messages"
tags: ["Messages"]
---

# List all Messages

`GET /Accounts/{AccountSid}/Messages`

List all messages.

#### Permissions
The API token must include the following scopes: _Messaging_.

## Path parameters

- `AccountSid` string, uuid, required

## Query parameters

- `DateCreated` string
- `DateSent` string
- `From` string
- `To` string

## Response `200`

The request has succeeded.

- MessageListResponse — Response containing a list of messages.
  - `uri` string — The URI of the current page.
  - `first_page_uri` string — The URI of the first page.
  - `next_page_uri` string — The URI of the next page.
  - `previous_page_uri` string, nullable — The URI of the previous page.
  - `page` integer — The current page number.
  - `page_size` integer — The number of items per page.
  - `messages` Message[] — List of messages.
    - `account_sid` string, uuid — The unique identifier of the project that sent or received this message.
    - `api_version` string — The version number of the SignalWire cXML REST API used to handle this message.
    - `body` string — The text of the message. Up to 1600 characters long.
    - `num_segments` integer — The number of segments that make up the entire message.
    - `num_media` string — The number of media files that were included with the message.
    - `date_created` string — The date and time the message was created in RFC 2822 format.
    - `date_sent` string — The date and time the message was sent in RFC 2822 format.
    - `date_updated` string — The date and time the message was last updated in RFC 2822 format.
    - `direction` 'inbound' | 'outbound-api' | 'outbound-call' | 'outbound-reply' — Message direction.
    - `error_code` string, nullable — If an error has occurred on the message, the error code will give you a specific code.
    - `error_message` string, nullable — A human readable description of the error that occurred.
    - `from` string — The phone number in E.164 format that sent the message.
    - `price` number, float — The cost of the individual message billed to your project.
    - `price_unit` string — The currency in which `price` is charged as.
    - `sid` string — A unique ID that identifies this specific message.
    - `status` 'queued' | 'sending' | 'sent' | 'delivered' | 'undelivered' | 'failed' | 'receiving' | 'received' — Message status.
    - `to` string — The phone number in E.164 format that received the message.
    - `messaging_service_sid` string, nullable — If a number group was used when sending an outbound message, the number group's ID will be present.
    - `uri` string — The URI of this particular message.
    - `subresource_uris` MessageSubresourceUris — Message subresource URIs.
      - `media` string — The URI for media.

## Other responses

- `401` — 401 Unauthorized response.

## Changes

- **2026-01-15** `686ef84c2abc` — 4 breaking
  - the response property `messages/items/error_code` became nullable for the status `200`
  - the response property `messages/items/error_message` became nullable for the status `200`
  - the response property `messages/items/messaging_service_sid` became nullable for the status `200`
  - the response property `previous_page_uri` became nullable for the status `200`
- **2026-01-15** `3c88f14db21e` — 1 breaking, 2 warning, 10 info
  - the response's body type changed from no type to `object` for status `200`
  - deleted the `query` request parameter `PageSize`
  - deleted the `query` request parameter `Status`
  - added the new optional `query` request parameter `DateCreated`
  - …9 more

[Change history](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/:AccountSid/Messages/get.md)

---

[API](https://skmtc.dev/signalwire/apis/compatibility-api.md) · [All operations](https://skmtc.dev/signalwire/apis/compatibility-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalwire/compatibility-api/revisions/686ef84c2abc/schema)