Skip to main content

List All Messages

Returns a paged list of messages sorted with the most recent messages appearing first.

Permissions

The API token must include the following scopes: Messaging.

Path Parameters
AccountSid uuid REQUIRED

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

Query Parameters
DateSent string

Only return messages sent on this particular date, formatted as YYYY-MM-DD in UTC. You can also append < or > to return a range of messages. For example, use DateSent< to return messages sent on or before midnight of the date, or DateSent> to return messages sent on or after midnight of the date.

From string

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.

To string

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 string

Possible values: [queued, sending, sent, delivered, undelivered, failed, receiving, received]

Current status of the message.

PageSize integer

Specify the number of results to return on a single page. The default page size is 50 and the maximum is 1000.

Responses
200

OK

Schema OPTIONAL
uri string OPTIONAL
first_page_uri string OPTIONAL
next_page_uri string OPTIONAL
previous_page_uri string OPTIONAL
page integer OPTIONAL
page_size integer OPTIONAL
messages object[] OPTIONAL
account_sid uuid OPTIONAL

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

api_version string OPTIONAL

The version number of the SignalWire Compatibility REST API used to handle this message.

body string OPTIONAL

The text of the message. Up to 1600 characters long and can be null if no message was sent.

num_segments integer OPTIONAL

The number of segments that make up the entire message. If the body of the message is larger than 160 GSM-7 characters or 70 UCS-2 characters, it will automatically be broken up into smaller messages and annotated to attempt proper reconstruction on the recipient handset. Not all carriers and handsets support this. SignalWire will recombine inbound messages into a single message. Your project will be charged for each segment sent or received.

num_media string OPTIONAL

The number of media files that were included with the message.

date_created string OPTIONAL

The date and time the message was created in RFC 2822 format.

date_sent string OPTIONAL

The date and time the message was sent in RFC 2822 format.

date_updated string OPTIONAL

The date and time the message was last updated in RFC 2822 format.

direction string OPTIONAL

Possible values: [inbound, outbound-api, outbound-call, outbound-reply]

The direction of the message.

error_code string OPTIONAL

If an error has occurred on the message, the error code will give you a specific code to help lookup more information on the failure. If no error occurred, error_code will be null.

error_message string OPTIONAL

A human readable description of the error that occurred. If no error occurred, error_message will be null.

from string OPTIONAL

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.

price integer OPTIONAL

The cost of the individual message billed to your project.

price_unit string OPTIONAL

The currency in which price is charged as.

sid string OPTIONAL

A unique ID that identifies this specific message.

status string OPTIONAL

Possible values: [queued, sending, sent, delivered, undelivered, failed, receiving, received]

Current status of the message.

to string OPTIONAL

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.

messaging_service_sid string OPTIONAL

If a number group was used when sending an outbound message, the number group's ID will be present. If no number group was used, the value will be null.

uri string OPTIONAL

The URI of this particular message.

subresource_uris object OPTIONAL

The URIs for any subresources associated with this message.

media string OPTIONAL