TWtwilio
ConversationsV2Conversation

List Conversations

Changed on

Retrieve a list of Conversations.

get/v2/Conversations

Request

  • Base URL
    https://conversations.twilio.com
  • URL
    https://conversations.twilio.com/v2/Conversations
  • Auth
    HTTP basic

Query parameters

statusstring[]

Filters for specific statuses

channelIdstring

The resource identifier (such as callSid or messageSid) to filter conversations.

pageSizeinteger
Example:50

Maximum number of items to return in a single response

pageTokenstring
Example:eyJwYWdlIjoyLCJxdWVyeSI6ImJvb2tzIn0=

A URL-safe, base64-encoded token representing the page of results to return

Response

OK

Example response

{
  "conversations": [
    {
      "id": "conv_conversation_00000000000000000000000001",
      "accountId": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "configurationId": "conv_configuration_00000000000000000000000001",
      "status": "ACTIVE",
      "name": "Customer Support - Multi-channel",
      "createdAt": "2023-07-01T12:00:00Z",
      "updatedAt": "2023-07-01T12:30:00Z",
      "metadata": {
        "zendesk_ticket_id": "TKT-456"
      }
    }
  ],
  "meta": {
    "key": "conversations",
    "pageSize": 20
  }
}

Changes

  • v24c4068f28797Revision changes
    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

  • v21abed68811c4Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status