GET friendships/show
Returns detailed information about the relationship between two arbitrary users.
Resource URL
https://api.twitter.com/1.1/friendships/show.json
Resource Information
Response formats
JSON
Requires authentication?
Yes
Rate limited?
Yes
Requests / 15-min window (user auth)
180
Requests / 15-min window (app auth)
15
Parameters
At least one source and one target, whether specified by IDs or screen_names, should be provided to this method.
source_id optional
The user_id of the subject user.
Example Values: 3191321
source_screen_name optional
The screen_name of the subject user.
Example Values: raffi
target_id optional
The user_id of the target user.
Example Values: 20
target_screen_name optional
The screen_name of the target user.
Example Values: noradio
OAuth Signature Generator
Sign in to see a list of your registered applications.
Example Request
GET
https://api.twitter.com/1.1/friendships/show.json?source_screen_name=bert&target_screen_name=ernie
Example Result
{ "relationship": { "target": { "id_str": "12148", "id": 12148, "screen_name": "ernie", "following": false, "followed_by": false }, "source": { "can_dm": false, "blocking": null, "muting": null, "id_str": "8649302", "all_replies": null, "want_retweets": null, "id": 8649302, "marked_spam": null, "screen_name": "bert", "following": false, "followed_by": false, "notifications_enabled": null } } }