Skip to main content
POST
Get DM History (XChat v3)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Parameters for getting DM history via XChat v3

recipient
string
required

User id, @handle, conversationId a:b, or group g....

Example:

"1928096185664843776:1989842918455291904"

Twitter authentication cookie or Twitter auth_token, how-to-get-twitter-cookie

Example:

"ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7"

pin
string | null
default:1234

Identity PIN (default 1234).

Example:

"1234"

count
integer | null
default:50

Max events per page (10–200, default 50).

Required range: 10 <= x <= 200
Example:

50

all
boolean | null
default:false

Follow has_more and return every page.

Example:

false

before
string | null

Oldest sequenceId for paging. Pass the previous page's oldest message sequence_id.

Example:

"2076684837654876160"

proxy
string | null

Optional HTTP proxy. Example: http://username:password@ip:port [blocked]

Example:

"http://username:password@ip:port"

Response

Conversation messages with pagination info.

Response for getting DM history via XChat v3

code
integer
required

Response code

Example:

200

msg
string
required

Response message

Example:

"success"

data
DmHistoryV3Data · object | null

DM history data