---
title: "Changes to Get Chat Conversations"
method: GET
path: "/2/chat/conversations"
---

# Changes to Get Chat Conversations

`GET /2/chat/conversations`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 20 revisions.

- **2026-11-03** `2e1fefa37444`: 2 breaking, 11 info
- **2026-10-26** `23643fd75fe0`: 3 breaking, 27 info
- **2026-08-15** `c74357dfe14e`: 72 breaking, 10 warning, 91 info
- **2026-05-12** `dd4e81f817ba`: 27 info
- **2026-02-08** `52da7efdbc92`: 1 info

## Changes

- **2026-11-03** `2e1fefa37444`: 2 breaking, 11 info
  - added `#/components/schemas/DmBadAttachmentProblem, #/components/schemas/DmBadCtaProblem, #/components/schemas/DmBadCustomProfileProblem, #/components/schemas/DmBadMediaProblem, #/components/schemas/DmBadQuickReplyProblem, #/components/schemas/DmBadUrlProblem, #/components/schemas/DmConversationNameTooLongProblem, #/components/schemas/DmConversationNotFoundProblem, #/components/schemas/DmDuplicateProblem, #/components/schemas/DmInactiveDeviceProblem, #/components/schemas/DmNotDeliveredProblem, #/components/schemas/DmNotFoundProblem, #/components/schemas/DmNotOwnerProblem, #/components/schemas/DmParticipantNotAddedProblem, #/components/schemas/DmParticipantNotFoundProblem, #/components/schemas/DmParticipantRestrictedProblem, #/components/schemas/DmParticipantUnavailableProblem, #/components/schemas/DmRateLimitedProblem, #/components/schemas/DmRecipientBlocksSenderProblem, #/components/schemas/DmRecipientCannotReceiveProblem, #/components/schemas/DmRecipientEncryptedUnavailableProblem, #/components/schemas/DmRecipientNotAcceptingProblem, #/components/schemas/DmRecipientNotFoundProblem, #/components/schemas/DmRecipientRestrictsGroupsProblem, #/components/schemas/DmRecipientUnavailableProblem, #/components/schemas/DmRequestInProgressProblem, #/components/schemas/DmSafetyLimitedProblem, #/components/schemas/DmSafetyRejectedProblem, #/components/schemas/DmSenderBlocksRecipientProblem, #/components/schemas/DmSenderDeclinedDmsProblem, #/components/schemas/DmSenderDmsClosedProblem, #/components/schemas/DmSenderEncryptedUnavailableProblem, #/components/schemas/DmSenderNotInConversationProblem, #/components/schemas/DmSenderNotPermittedProblem, #/components/schemas/DmSenderNotVerifiedProblem, #/components/schemas/DmSenderPhoneRequiredProblem, #/components/schemas/DmSenderReadOnlyProblem, #/components/schemas/DmSenderUnavailableProblem, #/components/schemas/DmTextEmptyProblem, #/components/schemas/DmTextTooLongProblem, #/components/schemas/DmTooFewParticipantsProblem, #/components/schemas/DmTooManyParticipantsProblem, #/components/schemas/DmUnsupportedMessageProblem` to the response body `oneOf` list for the response status `default`
  - added `#/components/schemas/DmBadAttachmentProblem, #/components/schemas/DmBadCtaProblem, #/components/schemas/DmBadCustomProfileProblem, #/components/schemas/DmBadMediaProblem, #/components/schemas/DmBadQuickReplyProblem, #/components/schemas/DmBadUrlProblem, #/components/schemas/DmConversationNameTooLongProblem, #/components/schemas/DmConversationNotFoundProblem, #/components/schemas/DmDuplicateProblem, #/components/schemas/DmInactiveDeviceProblem, #/components/schemas/DmNotDeliveredProblem, #/components/schemas/DmNotFoundProblem, #/components/schemas/DmNotOwnerProblem, #/components/schemas/DmParticipantNotAddedProblem, #/components/schemas/DmParticipantNotFoundProblem, #/components/schemas/DmParticipantRestrictedProblem, #/components/schemas/DmParticipantUnavailableProblem, #/components/schemas/DmRateLimitedProblem, #/components/schemas/DmRecipientBlocksSenderProblem, #/components/schemas/DmRecipientCannotReceiveProblem, #/components/schemas/DmRecipientEncryptedUnavailableProblem, #/components/schemas/DmRecipientNotAcceptingProblem, #/components/schemas/DmRecipientNotFoundProblem, #/components/schemas/DmRecipientRestrictsGroupsProblem, #/components/schemas/DmRecipientUnavailableProblem, #/components/schemas/DmRequestInProgressProblem, #/components/schemas/DmSafetyLimitedProblem, #/components/schemas/DmSafetyRejectedProblem, #/components/schemas/DmSenderBlocksRecipientProblem, #/components/schemas/DmSenderDeclinedDmsProblem, #/components/schemas/DmSenderDmsClosedProblem, #/components/schemas/DmSenderEncryptedUnavailableProblem, #/components/schemas/DmSenderNotInConversationProblem, #/components/schemas/DmSenderNotPermittedProblem, #/components/schemas/DmSenderNotVerifiedProblem, #/components/schemas/DmSenderPhoneRequiredProblem, #/components/schemas/DmSenderReadOnlyProblem, #/components/schemas/DmSenderUnavailableProblem, #/components/schemas/DmTextEmptyProblem, #/components/schemas/DmTextTooLongProblem, #/components/schemas/DmTooFewParticipantsProblem, #/components/schemas/DmTooManyParticipantsProblem, #/components/schemas/DmUnsupportedMessageProblem` to the `errors/items/` response property `oneOf` list for the response status `200`
  - added the new optional `query` request parameter `end_time`
  - added the new optional `query` request parameter `is_archived`
  - added the new optional `query` request parameter `is_muted`
  - added the new optional `query` request parameter `participant_ids`
  - added the new optional `query` request parameter `participant_query`
  - added the new optional `query` request parameter `start_time`
  - added the new optional `query` request parameter `type`
  - added the enum value `receives_your_chat` to the property `items/` of the `query` request parameter `user.fields`
  - added `https://api.x.com/2/problems/dm-bad-attachment, https://api.x.com/2/problems/dm-bad-cta, https://api.x.com/2/problems/dm-bad-custom-profile, https://api.x.com/2/problems/dm-bad-media, https://api.x.com/2/problems/dm-bad-quick-reply, https://api.x.com/2/problems/dm-bad-url, https://api.x.com/2/problems/dm-conversation-name-too-long, https://api.x.com/2/problems/dm-conversation-not-found, https://api.x.com/2/problems/dm-duplicate, https://api.x.com/2/problems/dm-inactive-device, https://api.x.com/2/problems/dm-not-delivered, https://api.x.com/2/problems/dm-not-found, https://api.x.com/2/problems/dm-not-owner, https://api.x.com/2/problems/dm-participant-not-added, https://api.x.com/2/problems/dm-participant-not-found, https://api.x.com/2/problems/dm-participant-restricted, https://api.x.com/2/problems/dm-participant-unavailable, https://api.x.com/2/problems/dm-rate-limited, https://api.x.com/2/problems/dm-recipient-blocks-sender, https://api.x.com/2/problems/dm-recipient-cannot-receive, https://api.x.com/2/problems/dm-recipient-encrypted-unavailable, https://api.x.com/2/problems/dm-recipient-not-accepting, https://api.x.com/2/problems/dm-recipient-not-found, https://api.x.com/2/problems/dm-recipient-restricts-groups, https://api.x.com/2/problems/dm-recipient-unavailable, https://api.x.com/2/problems/dm-request-in-progress, https://api.x.com/2/problems/dm-safety-limited, https://api.x.com/2/problems/dm-safety-rejected, https://api.x.com/2/problems/dm-sender-blocks-recipient, https://api.x.com/2/problems/dm-sender-declined-dms, https://api.x.com/2/problems/dm-sender-dms-closed, https://api.x.com/2/problems/dm-sender-encrypted-unavailable, https://api.x.com/2/problems/dm-sender-not-in-conversation, https://api.x.com/2/problems/dm-sender-not-permitted, https://api.x.com/2/problems/dm-sender-not-verified, https://api.x.com/2/problems/dm-sender-phone-required, https://api.x.com/2/problems/dm-sender-read-only, https://api.x.com/2/problems/dm-sender-unavailable, https://api.x.com/2/problems/dm-text-empty, https://api.x.com/2/problems/dm-text-too-long, https://api.x.com/2/problems/dm-too-few-participants, https://api.x.com/2/problems/dm-too-many-participants, https://api.x.com/2/problems/dm-unsupported-message` mapping keys to the response discriminator for the response status `default`
  - added the optional property `includes/users/items/receives_your_chat` to the response with the `200` status
  - added `https://api.x.com/2/problems/dm-bad-attachment, https://api.x.com/2/problems/dm-bad-cta, https://api.x.com/2/problems/dm-bad-custom-profile, https://api.x.com/2/problems/dm-bad-media, https://api.x.com/2/problems/dm-bad-quick-reply, https://api.x.com/2/problems/dm-bad-url, https://api.x.com/2/problems/dm-conversation-name-too-long, https://api.x.com/2/problems/dm-conversation-not-found, https://api.x.com/2/problems/dm-duplicate, https://api.x.com/2/problems/dm-inactive-device, https://api.x.com/2/problems/dm-not-delivered, https://api.x.com/2/problems/dm-not-found, https://api.x.com/2/problems/dm-not-owner, https://api.x.com/2/problems/dm-participant-not-added, https://api.x.com/2/problems/dm-participant-not-found, https://api.x.com/2/problems/dm-participant-restricted, https://api.x.com/2/problems/dm-participant-unavailable, https://api.x.com/2/problems/dm-rate-limited, https://api.x.com/2/problems/dm-recipient-blocks-sender, https://api.x.com/2/problems/dm-recipient-cannot-receive, https://api.x.com/2/problems/dm-recipient-encrypted-unavailable, https://api.x.com/2/problems/dm-recipient-not-accepting, https://api.x.com/2/problems/dm-recipient-not-found, https://api.x.com/2/problems/dm-recipient-restricts-groups, https://api.x.com/2/problems/dm-recipient-unavailable, https://api.x.com/2/problems/dm-request-in-progress, https://api.x.com/2/problems/dm-safety-limited, https://api.x.com/2/problems/dm-safety-rejected, https://api.x.com/2/problems/dm-sender-blocks-recipient, https://api.x.com/2/problems/dm-sender-declined-dms, https://api.x.com/2/problems/dm-sender-dms-closed, https://api.x.com/2/problems/dm-sender-encrypted-unavailable, https://api.x.com/2/problems/dm-sender-not-in-conversation, https://api.x.com/2/problems/dm-sender-not-permitted, https://api.x.com/2/problems/dm-sender-not-verified, https://api.x.com/2/problems/dm-sender-phone-required, https://api.x.com/2/problems/dm-sender-read-only, https://api.x.com/2/problems/dm-sender-unavailable, https://api.x.com/2/problems/dm-text-empty, https://api.x.com/2/problems/dm-text-too-long, https://api.x.com/2/problems/dm-too-few-participants, https://api.x.com/2/problems/dm-too-many-participants, https://api.x.com/2/problems/dm-unsupported-message` discriminator mapping keys to the `errors/items/` response property for the response status `200`
- **2026-10-26** `23643fd75fe0`: 3 breaking, 27 info
  - for the `query` request parameter `max_results`, default value was changed from `10` to `200`
  - added `#/components/schemas/RecipientNotMessageableProblem, #/components/schemas/DuplicateRuleProblem, #/components/schemas/InvalidRuleProblem` to the response body `oneOf` list for the response status `default`
  - added `#/components/schemas/RecipientNotMessageableProblem, #/components/schemas/DuplicateRuleProblem, #/components/schemas/InvalidRuleProblem` to the `errors/items/` response property `oneOf` list for the response status `200`
  - added the new optional `query` request parameter `unread_only`
  - for the `query` request parameter `max_results`, the max was increased from `100.00` to `1000.00`
  - added the enum value `active_follower_count` to the property `items/` of the `query` request parameter `user.fields`
  - added the enum value `admin_settings` to the property `items/` of the `query` request parameter `chat_conversation.fields`
  - added the enum value `group_description` to the property `items/` of the `query` request parameter `chat_conversation.fields`
  - added the enum value `group_description_key_version` to the property `items/` of the `query` request parameter `chat_conversation.fields`
  - added the enum value `invite` to the property `items/` of the `query` request parameter `chat_conversation.fields`
  - added the enum value `is_archived` to the property `items/` of the `query` request parameter `chat_conversation.fields`
  - added the enum value `last_read_event_id` to the property `items/` of the `query` request parameter `chat_conversation.fields`
  - added the enum value `newest_event_id` to the property `items/` of the `query` request parameter `chat_conversation.fields`
  - added the enum value `pending_member_ids` to the property `items/` of the `query` request parameter `chat_conversation.fields`
  - added the enum value `subscriber_count` to the property `items/` of the `query` request parameter `user.fields`
  - added the enum value `unread` to the property `items/` of the `query` request parameter `chat_conversation.fields`
  - added `https://api.twitter.com/2/problems/duplicate-rules, https://api.twitter.com/2/problems/invalid-rules, https://api.x.com/2/problems/recipient-not-messageable` mapping keys to the response discriminator for the response status `default`
  - added the optional property `data/items/admin_settings` to the response with the `200` status
  - added the optional property `data/items/group_description` to the response with the `200` status
  - added the optional property `data/items/group_description_key_version` to the response with the `200` status
  - added the optional property `data/items/invite` to the response with the `200` status
  - added the optional property `data/items/is_archived` to the response with the `200` status
  - added the optional property `data/items/last_read_event_id` to the response with the `200` status
  - added the optional property `data/items/newest_event_id` to the response with the `200` status
  - added the optional property `data/items/pending_member_ids` to the response with the `200` status
  - added the optional property `data/items/unread` to the response with the `200` status
  - added the optional property `includes/calls` to the response with the `200` status
  - added the optional property `includes/users/items/active_follower_count` to the response with the `200` status
  - added the optional property `includes/users/items/subscriber_count` to the response with the `200` status
  - added `https://api.twitter.com/2/problems/duplicate-rules, https://api.twitter.com/2/problems/invalid-rules, https://api.x.com/2/problems/recipient-not-messageable` discriminator mapping keys to the `errors/items/` response property for the response status `200`
- **2026-08-15** `c74357dfe14e`: 72 breaking, 10 warning, 91 info
  - removed the enum value `admin_ids` from the property `items/` of the `query` request parameter `chat_conversation.fields`
  - removed the enum value `affiliation` from the property `items/` of the `query` request parameter `user.fields`
  - removed the enum value `member_ids` from the property `items/` of the `query` request parameter `chat_conversation.fields`
  - removed the enum value `message_ttl_msec` from the property `items/` of the `query` request parameter `chat_conversation.fields`
  - removed the enum value `most_recent_tweet_id` from the property `items/` of the `query` request parameter `user.fields`
  - removed the enum value `participant_ids` from the property `items/` of the `query` request parameter `chat_conversation.fields`
  - removed the enum value `pinned_tweet_id` from the property `items/` of the `query` request parameter `user.fields`
  - added `#/components/schemas/ResourceNotFoundProblem, #/components/schemas/InvalidRequestProblem, #/components/schemas/NotAuthorizedForResourceProblem, #/components/schemas/NotAuthorizedForFieldProblem, #/components/schemas/FieldUnauthorizedProblem, #/components/schemas/FieldHydrationFailureProblem, #/components/schemas/ResourceUnavailableProblem, #/components/schemas/DisallowedResourceProblem, #/components/schemas/InternalErrorProblem` to the response body `oneOf` list for the response status `default`
  - the response's body type changed from `object` to no type for status `default`
  - the response property `includes/users/items/affiliation/badge_url` became nullable for the status `200`
  - the response property `includes/users/items/affiliation/description` became nullable for the status `200`
  - the response property `includes/users/items/affiliation/url` became nullable for the status `200`
  - the response property `includes/users/items/affiliation/user_id` became nullable for the status `200`
  - the response property `includes/users/items/entities/description` became nullable for the status `200`
  - the response property `includes/users/items/entities/description/cashtags` became nullable for the status `200`
  - the response property `includes/users/items/entities/description/hashtags` became nullable for the status `200`
  - the response property `includes/users/items/entities/description/mentions` became nullable for the status `200`
  - the response property `includes/users/items/entities/description/urls` became nullable for the status `200`
  - the response property `includes/users/items/entities/url` became nullable for the status `200`
  - the response property `includes/users/items/entities/url/urls` became nullable for the status `200`
  - the response property `includes/users/items/public_metrics/like_count` became nullable for the status `200`
  - the response property `includes/users/items/withheld/country_codes` became nullable for the status `200`
  - the response property `includes/users/items/withheld/scope` became nullable for the status `200`
  - the response property `data/items/id` became optional for the status `200`
  - the response property `includes/media/items/type` became optional for the status `200`
  - the response property `includes/places/items/full_name` became optional for the status `200`
  - the response property `includes/places/items/id` became optional for the status `200`
  - the response property `includes/polls/items/id` became optional for the status `200`
  - the response property `includes/polls/items/options` became optional for the status `200`
  - the response property `includes/topics/items/id` became optional for the status `200`
  - the response property `includes/topics/items/name` became optional for the status `200`
  - the response property `includes/users/items/id` became optional for the status `200`
  - the response property `includes/users/items/name` became optional for the status `200`
  - the response property `includes/users/items/username` became optional for the status `200`
  - the response property `includes/users/items/withheld/country_codes` became optional for the status `200`
  - the `includes/polls/items/options/items/label` response property's maxLength was unset from `25` for the response status `200`
  - the `errors` response property's minItems was decreased from `1` to `0` for the response status `200`
  - the `includes/media` response property's minItems was decreased from `1` to `0` for the response status `200`
  - the `includes/places` response property's minItems was decreased from `1` to `0` for the response status `200`
  - the `includes/places/items/contained_within` response property's minItems was decreased from `1` to `0` for the response status `200`
  - …133 more
- **2026-05-12** `dd4e81f817ba`: 27 info
  - added the optional property `includes/media` to the response with the `200` status
  - added the optional property `includes/places` to the response with the `200` status
  - added the optional property `includes/polls` to the response with the `200` status
  - added the optional property `includes/topics` to the response with the `200` status
  - added the optional property `includes/tweets` to the response with the `200` status
  - added the optional property `includes/users/items/affiliation` to the response with the `200` status
  - added the optional property `includes/users/items/connection_status` to the response with the `200` status
  - added the optional property `includes/users/items/created_at` to the response with the `200` status
  - added the optional property `includes/users/items/description` to the response with the `200` status
  - added the optional property `includes/users/items/entities` to the response with the `200` status
  - added the optional property `includes/users/items/location` to the response with the `200` status
  - added the optional property `includes/users/items/most_recent_tweet_id` to the response with the `200` status
  - added the optional property `includes/users/items/pinned_tweet_id` to the response with the `200` status
  - added the optional property `includes/users/items/profile_banner_url` to the response with the `200` status
  - added the optional property `includes/users/items/profile_image_url` to the response with the `200` status
  - added the optional property `includes/users/items/protected` to the response with the `200` status
  - added the optional property `includes/users/items/public_metrics` to the response with the `200` status
  - added the optional property `includes/users/items/receives_your_dm` to the response with the `200` status
  - added the optional property `includes/users/items/subscription_type` to the response with the `200` status
  - added the optional property `includes/users/items/url` to the response with the `200` status
  - added the optional property `includes/users/items/verified` to the response with the `200` status
  - added the optional property `includes/users/items/verified_type` to the response with the `200` status
  - added the optional property `includes/users/items/withheld` to the response with the `200` status
  - added the optional property `meta/has_more` to the response with the `200` status
  - added the required property `includes/users/items/id` to the response with the `200` status
  - added the required property `includes/users/items/name` to the response with the `200` status
  - added the required property `includes/users/items/username` to the response with the `200` status
- **2026-02-08** `52da7efdbc92`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/x/apis/x-api-v2/docs/2/chat/conversations/get.md) - [API](https://skmtc.dev/x/apis/x-api-v2.md) - [Page](https://skmtc.dev/x/apis/x-api-v2/changes/2/chat/conversations/get)