GET friendships/incoming

Updated on Sat, 2012-08-25 08:40

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

Resource URL

http://api.twitter.com/1/friendships/incoming.format

Parameters

cursor optional

Breaks the results into pages. This is recommended for users who are following many users. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.

Example Values: 12893764510938

stringify_ids optional

Many programming environments will not consume our ids due to their size. Provide this option to have ids returned as strings instead. More about Snowflake.

Example Values: true

Example Request

GET

https://api.twitter.com/1/friendships/incoming.json

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <id_list>
  3.   <ids>
  4.     <id>30592818</id>
  5.     <id>21249843</id>
  6.   </ids>
  7.   <next_cursor>1288724293877798413</next_cursor>
  8.   <previous_cursor>-1300794057949944903</previous_cursor>
  9. </id_list>
  10.