GET friendships/outgoing
get-friendships-outgoing

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.x.com/1.1/friendships/outgoing

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 Using cursors to navigate collections for more information.

 -1 12893764510938
stringify_ids optional Some programming environments will not consume Twitter IDs due to their size. Provide this option to have IDs returned as strings instead. More about Twitter IDs. false true

Example Request

GET https://api.x.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"
}