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
    }
  }
}