ConversationsParticipant Conversation

List Service Participant Conversation

GET
/v1/Services/{ChatServiceSid}/ParticipantConversations

Retrieve a list of all Conversations that this Participant belongs to by identity or by address. Only one parameter should be specified.

Authorization

accountSid_authToken
AuthorizationBasic <token>

In: header

Path Parameters

ChatServiceSid*string

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

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

Query Parameters

Identity?string

A unique string identifier for the conversation participant as Conversation User. This parameter is non-null if (and only if) the participant is using the Conversations SDK to communicate. Limited to 256 characters.

Address?string

A unique string identifier for the conversation participant who's not a Conversation User. This parameter could be found in messaging_binding.address field of Participant resource. It should be url-encoded.

PageSize?integer

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

Formatint64
Range1 <= value <= 50
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/ParticipantConversations?Identity=identity&Address=%2B375255555555"

{  "conversations": [],  "meta": {    "page": 0,    "page_size": 50,    "first_page_url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ParticipantConversations?Identity=identity&PageSize=50&Page=0",    "previous_page_url": null,    "url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ParticipantConversations?Identity=identity&PageSize=50&Page=0",    "next_page_url": null,    "key": "conversations"  }}