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)

Parameters

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. See [node:10362, title=”Using cursors to navigate collections”] for more information.

Example Values: 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. More about [node:194].

Example Values: true

OAuth Signature Generator

Example Request

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

Example Result

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

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