Users

Get DM conversation history

Returns message history with one user for the connected X account.

get/api/v1/x/dm/{userId}/history

Path parameters

userIdstring required

Target user ID

Query parameters

accountstring required

X handle (without the @ prefix) of the connected X account used to read the conversation. The account must be a participant in the conversation.

cursorstring

Pagination cursor for DM history

maxIdstring

Legacy pagination cursor (backward compat)

Response

List of DM messages

has_next_pageboolean required

next_cursorstring required

Example response

{
  "messages": [
    {
      "id": "1234567890123456789",
      "text": "Hey, how are you?",
      "senderId": "9876543210",
      "receiverId": "1234567890"
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}

Changes

Changed in 3 of the 22 revisions of this API.12165

Aug 21, 202618302a60cfee11See the full diff
- ▲
  the / response's property type changed from no type to object for status
  response-property-type-changed
- ○
  added 'propertyNames' constraint to the / response property for the status
  response-property-property-names-added
Aug 12, 20265d4938bb7de3162See the full diff
- ●
  added the new closed enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the /////// response property for the response status
  response-property-enum-value-added
Aug 12, 20264da209b29df8544See the full diff
- ●
  added the new coverage_cursor_gone enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the ////// response property for the response status (media type: application/json)
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the /////// response property for the response status (media type: application/json)
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the ////// response property for the response status (media type: application/json)
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the /////// response property for the response status (media type: application/json)
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the ////// response property for the response status (media type: application/json)
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the /////// response property for the response status (media type: application/json)
  response-property-enum-value-added
- ○
  response property oneOf[AuthenticatedPaymentRequired]/payment_options/credits/create_checkout/provider deprecated (media type: application/json)
  response-property-deprecated
- ○
  response property oneOf[AuthenticatedPaymentRequired]/payment_options/subscription/create_checkout/provider deprecated (media type: application/json)
  response-property-deprecated
- ○
  response property oneOf[GuestPaymentRequired]/payment_options/credits/create_checkout/provider deprecated (media type: application/json)
  response-property-deprecated
- ○
  response property payment_options/guest_wallet/create_checkout/provider deprecated (media type: application/problem+json)
  response-property-deprecated

Full history