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

Users

Changed on Oct 20, 2026

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

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

Request

Base URL: https://xquik.com
URL: https://xquik.com/api/v1/x/dm/{userId}/history
Auth: one of:
- API key in header x-api-key
- HTTP bearer

Path parameters

userIdstring required

The other person in the conversation, as a user ID, username with or without @, or URL-encoded profile URL, such as x.com/nasa. Xquik looks up a username's ID first. Anything else gets 400 invalid_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 collection results. Also read as next_cursor, next_token, pagination_token or continuation_token.

maxIdstring

Legacy pagination cursor (backward compat)

Response

List of DM messages

has_next_pageboolean required

next_cursorstring required

Cursor for the next page. Send it unchanged.

Example response

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

Changes

Oct 20, 202645942c75fdc2 Revision changes
- warning
  added the new topup_in_progress enum value to the ///// response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the /////// response property for the response status

Operation history