GET friendships/outgoing

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

Resource URL

https://api.twitter.com/1.1/friendships/outgoing.format

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

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

Example Request

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

Example Response

{
  "previous_cursor": 0,
  "ids": [
    51937528,
    124856868,
    213246307,
    89356977,
    121177351,
    113338333,
    59520091,
    46451699,
    98223312,
    18172433,
    32210115,
    36851055,
    81269257
  ],
  "previous_cursor_str": "0",
  "next_cursor": 0,
  "next_cursor_str": "0"
}