List Messages

Retrieve all messages from your account.

External Documentation

To learn more, visit the Twilio documentation.

Parameters

Parameter	Description
After	Filter for messages sent in given date. To find Messages with sent_dates on and after a specific dateate.
Before	Filter for messages sent in given date. To find Messages with sent_dates on and before a specific date.
From	Filter for messages sent by this phone number.
Page Size	Set the size of the page returned.
To	Filter for messages received by this phone number.

Example Output

{
    "end": 1,
    "first_page_uri": "/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages.json?To=%2B123456789&From=%2B987654321&DateSent%3E=2008-01-02&PageSize=2&Page=0",
    "next_page_uri": "/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages.json?To=%2B123456789&From=%2B987654321&DateSent%3E=2008-01-02&PageSize=2&Page=1&PageToken=PAMMc26223853f8c46b4ab7dfaa6abba0a26",
    "page": 0,
    "page_size": 2,
    "previous_page_uri": "/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages.json?To=%2B123456789&From=%2B987654321&DateSent%3E=2008-01-02&PageSize=2&Page=0",
    "messages": [
        {
            "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "api_version": "2010-04-01",
            "body": "testing",
            "date_created": "Fri, 24 May 2019 17:44:46 +0000",
            "date_sent": "Fri, 24 May 2019 17:44:50 +0000",
            "date_updated": "Fri, 24 May 2019 17:44:50 +0000",
            "direction": "outbound-api",
            "error_code": null,
            "error_message": null,
            "from": "+12019235161",
            "messaging_service_sid": null,
            "num_media": "0",
            "num_segments": "1",
            "price": "-0.00750",
            "price_unit": "USD",
            "sid": "SMded05904ccb347238880ca9264e8fe1c",
            "status": "sent",
            "subresource_uris": {
                "media": "/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages/SMded05904ccb347238880ca9264e8fe1c/Media.json",
                "feedback": "/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages/SMded05904ccb347238880ca9264e8fe1c/Feedback.json"
            },
            "tags": {
                "campaign_name": "Spring Sale 2022",
                "message_type": "cart_abandoned"
            },
            "to": "+18182008801",
            "uri": "/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages/SMded05904ccb347238880ca9264e8fe1c.json"
        },
        {
            "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "api_version": "2010-04-01",
            "body": "look mom I have media!",
            "date_created": "Fri, 24 May 2019 17:44:46 +0000",
            "date_sent": "Fri, 24 May 2019 17:44:49 +0000",
            "date_updated": "Fri, 24 May 2019 17:44:49 +0000",
            "direction": "inbound",
            "error_code": 30004,
            "error_message": "Message blocked",
            "from": "+12019235161",
            "messaging_service_sid": null,
            "num_media": "3",
            "num_segments": "1",
            "price": "-0.00750",
            "price_unit": "USD",
            "sid": "MMc26223853f8c46b4ab7dfaa6abba0a26",
            "status": "received",
            "subresource_uris": {
                "media": "/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages/MMc26223853f8c46b4ab7dfaa6abba0a26/Media.json",
                "feedback": "/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages/MMc26223853f8c46b4ab7dfaa6abba0a26/Feedback.json"
            },
            "tags": {
                "campaign_name": "Spring Sale 2022",
                "message_type": "cart_abandoned"
            },
            "to": "+18182008801",
            "uri": "/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages/MMc26223853f8c46b4ab7dfaa6abba0a26.json"
        }
    ],
    "start": 0,
    "uri": "/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages.json?To=%2B123456789&From=%2B987654321&DateSent%3E=2008-01-02&PageSize=2&Page=0"
}

Workflow Library Example

List Messages with Twilio and Send Results Via Email

Preview this Workflow on desktop