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.twitter.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

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.twitter.com/1.1/friendships/incoming.json

Example Response

{
  "previous_cursor": 0,
  "ids": [

  ],
  "previous_cursor_str": "0",
  "next_cursor": 0,
  "next_cursor_str": "0"
}