GET lists/show
Returns the specified list. Private lists will only be shown if the authenticated user owns the specified list.
Resource URL
https://api.twitter.com/1.1/lists/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
Either a list_id
or a slug
is required. If providing a list_slug
, an owner_screen_name
or owner_id
is also required.
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.
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
.
OAuth Signature Generator
Sign in to see a list of your registered applications.
Example Request
GET
https://api.twitter.com/1.1/lists/show.json?slug=team&owner_screen_name=twitter
Example Result
{ "created_at": "Wed Sep 23 01:18:01 +0000 2009", "slug": "team", "name": "Team", "full_name": "@twitter/team", "description": "", "mode": "public", "following": false, "user": { "geo_enabled": true, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme18/bg.gif", "profile_background_color": "ACDED6", "protected": false, "listed_count": 66019, "profile_background_tile": false, "created_at": "Tue Feb 20 14:35:54 +0000 2007", "friends_count": 695, "name": "Twitter", "profile_sidebar_fill_color": "F6F6F6", "notifications": false, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/1124040897/at-twitter_normal.png", "description": "Always wondering what's happening. ", "display_url": null, "following": false, "verified": true, "favourites_count": 16, "profile_sidebar_border_color": "EEEEEE", "followers_count": 6619092, "profile_image_url": "http://a0.twimg.com/profile_images/1124040897/at-twitter_normal.png", "default_profile_image": false, "contributors_enabled": true, "deactivated_bit": false, "statuses_count": 1218, "profile_use_background_image": true, "location": "San Francisco, CA", "id_str": "783214", "default_profile": false, "show_all_inline_media": true, "profile_text_color": "333333", "screen_name": "twitter", "follow_request_sent": false, "profile_background_image_url": "http://a1.twimg.com/images/themes/theme18/bg.gif", "url": "http://blog.twitter.com/", "expanded_url": null, "is_translator": false, "time_zone": "Pacific Time (US & Canada)", "profile_link_color": "038543", "id": 783214, "entities": { "urls": [], "user_mentions": [], "hashtags": [] }, "suspended": false, "lang": "en" }, "member_count": 643, "id_str": "574", "subscriber_count": 76779, "id": 574, "uri": "/twitter/team" }