Sign in
Users

Get DM conversation history

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

get/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 13 revisions of this API.11925

  • 5b381ffca02c11See 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

  • 73cd0a1d989c144See 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 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_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_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 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

  • d5855df0e349484See 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 (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 (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 (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