Sign in

v36

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-1279125449.6 KB
Messages

List all Messages

List all messages.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Messaging.

Learn more about API scopes.

get/Accounts/{AccountSid}/Messages

Path parameters

AccountSidstring uuid required

Universal Unique Identifier.

The unique identifier of the project that sent or received this message.

Query parameters

DateSentstring

Only return messages sent on this particular date, formatted as YYYY-MM-DD in UTC.

DateSent<string

Only return messages sent before this date, formatted as YYYY-MM-DD in UTC.

DateSent>string

Only return messages sent after this date, formatted as YYYY-MM-DD in UTC.

Fromstring

The phone number in E.164 format. For inbound messages, this will be the remote phone number who sent the message. For outbound messages, this will be one of your SignalWire phone numbers.

Tostring

The phone number in E.164 format that received the message. For inbound messages, this is one of your SignalWire phone numbers; for outbound messages, this is the remote phone number that received the message.

Status'queued' | 'initiated' | 'sent' | 'failed' | 'delivered' | 'undelivered' | 'received'

Message status.

Current status of the message.

Pageinteger

The page number to retrieve. Default is 0.

PageSizeinteger

The number of items per page. Default is 50, maximum is 1000.

PageTokenstring

The token for cursor-based pagination. Must start with 'PA' or 'PB'.

Response

The request has succeeded.

uristring required

The URI of the current page.

first_page_uristring required

The URI of the first page.

next_page_uristring nullable required

The URI of the next page, or null if there are no more pages.

previous_page_uristring nullable required

The URI of the previous page, or null if this is the first page.

pageinteger required

The current page number.

page_sizeinteger required

The number of items per page.

Example response

{
  "uri": "/api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages?Page=0&PageSize=50",
  "first_page_uri": "/api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages?Page=0&PageSize=50",
  "next_page_uri": "/api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages?Page=1&PageSize=50&PageToken=PA0a059168ead041af",
  "page_size": 50,
  "messages": [
    {
      "api_version": "2010-04-01",
      "body": "Hello World!",
      "num_segments": 1,
      "num_media": 1,
      "date_created": "Mon, 13 Aug 2018 21:38:46 +0000",
      "date_sent": "Mon, 13 Aug 2018 21:38:46 +0000",
      "date_updated": "Mon, 13 Aug 2018 21:38:46 +0000",
      "error_code": "30001",
      "error_message": "Queue overflow",
      "from": "+15551234567",
      "price": 0.005,
      "price_unit": "USD",
      "to": "+15557654321",
      "uri": "/api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages/0a059168-ead0-41af-9d1f-343dae832527.json",
      "subresource_uris": {
        "media": "/api/laml/2010-04-01/Accounts/ea108133-d6b3-407c-9536-9fad8a929a6a/Messages/0a059168-ead0-41af-9d1f-343dae832527/Media.json"
      }
    }
  ]
}