TWtwilio
ConversationsV2Communication

List Communications

Changed on

Retrieve a list of Communications in a Conversation.

get/v2/Conversations/{ConversationId}/Communications

Request

  • Base URL
    https://conversations.twilio.com
  • URL
    https://conversations.twilio.com/v2/Conversations/{ConversationId}/Communications
  • Auth
    HTTP basic

Query parameters

channelIdstring

Resource identifier to filter communications

pageSizeinteger
Example:50

Maximum number of items to return

pageTokenstring

Page token for pagination

Response

OK

Example response

{
  "communications": [
    {
      "id": "conv_communication_00000000000000000000000001",
      "conversationId": "conv_conversation_00000000000000000000000001",
      "accountId": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "author": {
        "address": "+18005550100",
        "channel": "SMS",
        "participantId": "conv_participant_00000000000000000000000001"
      },
      "content": {
        "type": "TEXT",
        "text": "Hello, I need help with my order"
      },
      "resourceId": "SM12345678901234567890123456789012",
      "recipients": [
        {
          "address": "+18005550102",
          "channel": "SMS",
          "participantId": "conv_participant_00000000000000000000000002",
          "deliveryStatus": "DELIVERED"
        }
      ],
      "createdAt": "2023-07-01T12:15:00Z",
      "updatedAt": "2023-07-01T12:15:05Z"
    }
  ],
  "meta": {
    "key": "communications"
  }
}

Changes

  • v2623775ae5ff1Revision changes
    • warning

      added the new VIDEO enum value to the /// response property for the response status

    • warning

      added the new VIDEO enum value to the //////// response property for the response status

  • v2f039dce07916Revision changes
    • warning

      added the new READ enum value to the ///// response property for the response status