Retrieve a list of conversations in your service
A Service Conversation resource represents an omnichannel group conversation with an ordered list of messages and a participant roster.
Retrieve a list of conversations in your service
Path parameters
-
The SID of the Conversation Service the Conversation resource is associated with.
Query parameters
-
PageSize integer
How many resources to return in each list page. The default is 50, and the maximum is 1000.
Minimum value is
1
, maximum value is1000
.
GET /v1/Services/{ChatServiceSid}/Conversations
curl \
-X GET https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Conversations \
--user "username:password"
Response examples (200)
{
"conversations": [
{
"account_sid": "string",
"attributes": "string",
"chat_service_sid": "string",
"date_created": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"friendly_name": "string",
"links": {},
"messaging_service_sid": "string",
"sid": "string",
"state": "inactive",
"unique_name": "string",
"url": "https://example.com"
}
],
"meta": {
"first_page_url": "https://example.com",
"key": "string",
"next_page_url": "https://example.com",
"page": 42,
"page_size": 42,
"previous_page_url": "https://example.com",
"url": "https://example.com"
}
}
Response examples (200)
{
"conversations": [
{
"account_sid": "string",
"attributes": "string",
"chat_service_sid": "string",
"date_created": "2024-05-04T09:42:00+00:00",
"date_updated": "2024-05-04T09:42:00+00:00",
"friendly_name": "string",
"links": {},
"messaging_service_sid": "string",
"sid": "string",
"state": "inactive",
"unique_name": "string",
"url": "https://example.com"
}
],
"meta": {
"first_page_url": "https://example.com",
"key": "string",
"next_page_url": "https://example.com",
"page": 42,
"page_size": 42,
"previous_page_url": "https://example.com",
"url": "https://example.com"
}
}