---
title: "GET /v1/ParticipantConversations"
method: GET
path: "/v1/ParticipantConversations"
---

# GET /v1/ParticipantConversations

`GET /v1/ParticipantConversations`

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

## Query parameters

- `Identity` string
- `Address` string
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `conversations` ConversationsV1ParticipantConversation[]
    - `account_sid` string, nullable — The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation.
    - `chat_service_sid` string, nullable — The unique ID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) this conversation belongs to.
    - `conversation_attributes` string, nullable — An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. **Note** that if the attributes are not set "{}" will be returned.
    - `conversation_created_by` string, nullable — Identity of the creator of this Conversation.
    - `conversation_date_created` string, date-time, nullable — The date that this conversation was created, given in ISO 8601 format.
    - `conversation_date_updated` string, date-time, nullable — The date that this conversation was last updated, given in ISO 8601 format.
    - `conversation_friendly_name` string, nullable — The human-readable name of this conversation, limited to 256 characters. Optional.
    - `conversation_sid` string, nullable — The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) this Participant belongs to.
    - `conversation_state` 'inactive' | 'active' | 'closed'
    - `conversation_timers` unknown
    - `conversation_unique_name` string, nullable — An application-defined string that uniquely identifies the Conversation resource.
    - `links` object, nullable — Contains absolute URLs to access the [participant](https://www.twilio.com/docs/conversations/api/conversation-participant-resource) and [conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) of this conversation.
    - `participant_identity` string, nullable — A unique string identifier for the conversation participant as [Conversation User](https://www.twilio.com/docs/conversations/api/user-resource). This parameter is non-null if (and only if) the participant is using the Conversations SDK to communicate. Limited to 256 characters.
    - `participant_messaging_binding` unknown
    - `participant_sid` string, nullable — The unique ID of the [Participant](https://www.twilio.com/docs/conversations/api/conversation-participant-resource).
    - `participant_user_sid` string, nullable — The unique string that identifies the conversation participant as [Conversation User](https://www.twilio.com/docs/conversations/api/user-resource).
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

---

[API](https://skmtc.net/twilio/apis/twilio-conversations-v1.md) · [All operations](https://skmtc.net/twilio/apis/twilio-conversations-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/twilio-conversations-v1/versions/fa436aa9c960/schema)