GET lists/members/show

Check if the specified user is a member of the specified list.

Resource URL

https://api.twitter.com/1.1/lists/members/show.json

Resource Information

Response formats JSON
Requires authentication? Yes
Rate limited? Yes
Requests / 15-min window (user auth) 15
Requests / 15-min window (app auth) 15

Parameters

Name Required Description Default Value Example
list_id required The numerical id of the list.
slug required You can identify a list by its slug instead of its numerical id. If you decide to do so, note that you'll also have to specify the list owner using the owner_id or owner_screen_name parameters.
user_id required The ID of the user for whom to return results. Helpful for disambiguating when a valid user ID is also a valid screen name.
screen_name required The screen name of the user for whom to return results. Helpful for disambiguating when a valid screen name is also a user ID.
owner_screen_name optional The screen name of the user who owns the list being requested by a slug.
owner_id optional The user ID of the user who owns the list being requested by a slug.
include_entities optional When set to either true, t or 1, each tweet will include a node called "entities". This node offers a variety of metadata about the tweet in a discreet structure, including: user_mentions, urls, and hashtags. While entities are opt-in on timelines at present, they will be made a default component of output in the future. See Tweet Entities for more details.
skip_status optional When set to either true, t or 1 statuses will not be included in the returned user objects.

Example Request

GET https://api.twitter.com/1.1/lists/members/show.json?slug=team&owner_screen_name=twitter&screen_name=froginthevalley

Example Response

{
  "id": "657693",
  "id_str": "657693",
  "is_translator": false,
  "default_profile": false,
  "entities": {
    "url": {
      "urls": [
        {
          "url": "http://t.co/jtb0IaGT",
          "indices": [
            0,
            20
          ],
          "display_url": "afroginthevalley.com",
          "expanded_url": "http://afroginthevalley.com/"
        }
      ]
    },
    "description": {
      "urls": []
    }
  },
  "show_all_inline_media": false,
  "profile_use_background_image": false,
  "profile_text_color": "999999",
  "utc_offset": -18000,
  "listed_count": 302,
  "name": "Sylvain Carle",
  "notifications": false,
  "profile_sidebar_border_color": "87CB00",
  "geo_enabled": true,
  "follow_request_sent": false,
  "url": "http://t.co/jtb0IaGT",
  "lang": "en",
  "profile_image_url_https": "https://si0.twimg.com/profile_images/1532782858/sylvaincarle-2011-profile-480_normal.png",
  "created_at": "Thu Jan 18 00:10:45 +0000 2007",
  "protected": false,
  "followers_count": 4281,
  "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/228591248/bg-14.png",
  "screen_name": "froginthevalley",
  "profile_background_tile": true,
  "friends_count": 2367,
  "profile_sidebar_fill_color": "333333",
  "description": "Developer Advocate at Twitter. Internet, opensource, media & geo/local geek. See also @sylvaincarle for LANG=FR.",
  "time_zone": "Eastern Time (US & Canada)",
  "default_profile_image": false,
  "location": "San Francisco",
  "profile_image_url": "http://a0.twimg.com/profile_images/1532782858/sylvaincarle-2011-profile-480_normal.png",
  "favourites_count": 1790,
  "following": false,
  "profile_background_color": "000000",
  "verified": false,
  "statuses_count": 8191,
  "status": {
    "entities": {
      "urls": [
        {
          "url": "http://t.co/GtBxX0IW",
          "indices": [
            54,
            74
          ],
          "display_url": "example.com",
          "expanded_url": "http://www.example.com"
        },
        {
          "url": "http://t.co/2E5hDjME",
          "indices": [
            94,
            114
          ],
          "display_url": "example.com",
          "expanded_url": "http://example.com"
        }
      ],
      "hashtags": [],
      "user_mentions": [
        {
          "name": "VO5",
          "indices": [
            0,
            6
          ],
          "screen_name": "MyVO5",
          "id": "485879570",
          "id_str": "485879570"
        }
      ]
    },
    "geo": null,
    "place": null,
    "in_reply_to_screen_name": "MyVO5",
    "in_reply_to_user_id": 485879570,
    "retweeted": false,
    "in_reply_to_status_id": 243404113679888400,
    "created_at": "Wed Sep 05 17:45:14 +0000 2012",
    "possibly_sensitive": false,
    "in_reply_to_status_id_str": "243404113679888385",
    "contributors": null,
    "favorited": false,
    "source": "YoruFukurou",
    "in_reply_to_user_id_str": "485879570",
    "retweet_count": 0,
    "id": "< Unable to parse in Javascript >",
    "id_str": "243404435752099841",
    "coordinates": null,
    "truncated": false,
    "text": "@MyVO5 make sure you configure your domain correctly, http://t.co/GtBxX0IW is not the same as http://t.co/2E5hDjME (also, refresh cache)."
  },
  "contributors_enabled": false,
  "profile_background_image_url": "http://a0.twimg.com/profile_background_images/228591248/bg-14.png",
  "profile_link_color": "009DFF"
}

Was this document helpful?

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.