GET friendships/incoming

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

Resource URL

Resource Information

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


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

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].   true

Example Request


Example Response

  "previous_cursor": 0,
  "ids": [

  "previous_cursor_str": "0",
  "next_cursor": 0,
  "next_cursor_str": "0"