ConversationsMessage

List Service Conversation Message

GET
/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages

Retrieve a list of all messages in the conversation

Authorization

accountSid_authToken
AuthorizationBasic <token>

In: header

Path Parameters

ChatServiceSid*string

The SID of the Conversation Service the Participant resource is associated with.

Match^IS[0-9a-fA-F]{32}$
Length34 <= length <= 34
ConversationSid*string

The unique ID of the Conversation for messages.

Query Parameters

Order?ServiceConversationMessageOrderType

The sort order of the returned messages. Can be: asc (ascending) or desc (descending), with asc as the default.

Value in

  • "asc"
  • "desc"
PageSize?integer

How many resources to return in each list page. The default is 50, and the maximum is 100.

Formatint64
Range1 <= value <= 100
Page?integer

The page index. This value is simply for client state.

Range0 <= value
PageToken?string

The page token. This is provided by the API.

Response Body

application/json

curl -X GET "https://example.com/v1/Services/stringstringstringstringstringstri/Conversations/string/Messages?Order=desc"

{  "meta": {    "page": 0,    "page_size": 50,    "first_page_url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conversations/CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages?PageSize=50&Page=0",    "previous_page_url": null,    "url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conversations/CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages?PageSize=50&Page=0",    "next_page_url": null,    "key": "messages"  },  "messages": [    {      "sid": "IMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "chat_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "conversation_sid": "CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "body": "I like pie.",      "media": null,      "author": "pie_preferrer",      "participant_sid": "MBaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "attributes": "{ \"importance\": \"high\" }",      "date_created": "2016-03-24T20:37:57Z",      "date_updated": "2016-03-24T20:37:57Z",      "index": 0,      "delivery": {        "total": 2,        "sent": "all",        "delivered": "some",        "read": "some",        "failed": "none",        "undelivered": "none"      },      "content_sid": null,      "url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conversations/CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/IMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "links": {        "delivery_receipts": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conversations/CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/IMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Receipts",        "channel_metadata": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conversations/CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/IMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelMetadata"      }    },    {      "sid": "IMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "chat_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "conversation_sid": "CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "body": "Cake is my favorite!",      "media": null,      "author": "cake_lover",      "participant_sid": "MBaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "attributes": "{ \"importance\": \"high\" }",      "date_created": "2016-03-24T20:38:21Z",      "date_updated": "2016-03-24T20:38:21Z",      "index": 0,      "delivery": {        "total": 2,        "sent": "all",        "delivered": "some",        "read": "some",        "failed": "none",        "undelivered": "none"      },      "content_sid": null,      "url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conversations/CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/IMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "links": {        "delivery_receipts": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conversations/CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/IMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Receipts",        "channel_metadata": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conversations/CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/IMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelMetadata"      }    },    {      "sid": "IMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "chat_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "conversation_sid": "CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "body": null,      "media": [        {          "sid": "MEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",          "size": 42056,          "content_type": "image/jpeg",          "filename": "car.jpg"        }      ],      "author": "cake_lover",      "participant_sid": "MBaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "attributes": "{ \"importance\": \"high\" }",      "date_created": "2016-03-24T20:38:21Z",      "date_updated": "2016-03-24T20:38:21Z",      "index": 0,      "delivery": {        "total": 2,        "sent": "all",        "delivered": "some",        "read": "some",        "failed": "none",        "undelivered": "none"      },      "content_sid": null,      "url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conversations/CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/IMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "links": {        "delivery_receipts": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conversations/CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/IMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Receipts",        "channel_metadata": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conversations/CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/IMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelMetadata"      }    }  ]}