Skip to main content
GET
Get Chat Message Requests

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

FlowAuthorization Code
Authorization URL
https://api.x.com/2/oauth2/authorize
Token URL
https://api.x.com/2/oauth2/token
Scopes3
users.read
View any account you can see, including protected accounts.
dm.read
Read all your Direct Messages.
tweet.read
View all posts you can see, including those from protected accounts.

Query Parameters

inbox_type
enum<string>
default:you_may_know

Which message request inbox to list: you_may_know (the apps' Priority tab) or low_quality (the apps' Hidden tab).

Available options:
you_may_know,
low_quality
max_results
integer<int32>
default:10

The maximum number of message requests to return.

Required range: 1 <= x <= 50
pagination_token
string

The next_token from a previous response, to fetch the next page.

Pattern: ^[0-9]{1,10}$

Response

The request has succeeded.

data
object[]
errors
object[]
meta
object