<< Back to Twitter API Documentation

Twitter REST API Method: GET /:user/lists/:id

Show the specified list. Private lists will only be shown if the authenticated user owns the specified list.

URL:

http://api.twitter.com/1/user/lists/id.format

Formats: 

xml, json

HTTP Method(s):

GET

Requires Authentication (about authentication):

true

API rate limited (about rate limiting):

false

Parameters:

• id.  Required. The id or slug of the list.

Usage examples:

cURL (about cURL):

curl -u user:password http://api.twitter.com/1/twitterapidocs/lists/doctors.xml

Response (about return values): 

XML example:

<list>

  <id>2025372</id>

  <name>surgeons</name>

  <full_name>@twitterapidocs/surgeons</full_name>

  <slug>surgeons</slug>

  <description></description>

  <subscriber_count>0</subscriber_count>

  <member_count>0</member_count>

  <uri>/twitterapidocs/surgeons</uri>

  <mode>private</mode>

  <user>

    <id>86621024</id>

    <name>API Documentation</name>

    <screen_name>twitterapidocs</screen_name>

    <location></location>

    <description>The @twitterapi team uses me to generate API documentation.</description>

    <profile_image_url>http://s.twimg.com/a/1257288876/images/default_profile_0_normal.png</profile_image_url>

    <url></url>

    <protected>false</protected>

    <followers_count>0</followers_count>

    <profile_background_color>9ae4e8</profile_background_color>

    <profile_text_color>000000</profile_text_color>

    <profile_link_color>0000ff</profile_link_color>

    <profile_sidebar_fill_color>e0ff92</profile_sidebar_fill_color>

    <profile_sidebar_border_color>87bc44</profile_sidebar_border_color>

    <friends_count>0</friends_count>

    <created_at>Sat Oct 31 23:21:40 +0000 2009</created_at>

    <favourites_count>0</favourites_count>

    <utc_offset></utc_offset>

    <time_zone></time_zone>

    <profile_background_image_url>http://s.twimg.com/a/1257288876/images/themes/theme1/bg.png</profile_background_image_url>

    <profile_background_tile>false</profile_background_tile>

    <statuses_count>0</statuses_count>

    <notifications>false</notifications>

    <geo_enabled>false</geo_enabled>

    <verified>false</verified>

    <following>false</following>

  </user>

</list>