get-friendships-incoming

GET friendships/incoming

Returns a collection of numeric IDs for every user who has a pending request to follow the authenticating user.

Resource URL¶

https://api.x.com/1.1/friendships/incoming.json

Resource Information¶

Response formats	JSON
Requires authentication?	Yes (user context only)
Rate limited?	Yes
Requests / 15-min window (user auth)	15

Parameters¶

Name Required Description Default Value Example

cursor

semi-optional

Name	Required	Description	Default Value	Example
cursor	semi-optional	Causes the list of connections to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to be 5000 as suspended users are filtered out after connections are queried. If no cursor is provided, a value of `-1` will be assumed, which is the first "page." The response from the API will include a `previous_cursor` and `next_cursor` to allow paging back and forth.		`12893764510938`
stringify_ids	optional	Many programming environments will not consume our Tweet ids due to their size. Provide this option to have ids returned as strings instead.		`true`

Causes the list of connections to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to be 5000 as suspended users are filtered out after connections are queried. If no cursor is provided, a value of -1 will be assumed, which is the first "page."

The response from the API will include a previous_cursor and next_cursor to allow paging back and forth.

12893764510938

stringify_ids optional Many programming environments will not consume our Tweet ids due to their size. Provide this option to have ids returned as strings instead. true

Example Request¶

GET https://api.x.com/1.1/friendships/incoming.json

Example Response¶

{
  "previous_cursor": 0,
  "ids": [6253282],
  "previous_cursor_str": "0",
  "next_cursor": 0,
  "next_cursor_str": "0"
}