## Twitter API

Base url https://api.twitter.com/1.1/

Version 1.1

### Security

#### oauth_1_0

Twitter offers applications the ability to issue authenticated requests on behalf of the application itself (as opposed to on behalf of a specific user).

## oauth_1_0

#### Request

- #### Response

- #### Settings

- Authorization Uri: https://api.twitter.com/oauth/authorize

### Resources

URl: /statuses

#### statuses

URl: /statuses/mentions_timeline{mediaTypeExtension}
GET

#### statuses mentions_timeline{mediaTypeExtension}

GET
/statuses/mentions_timeline{mediaTypeExtension}
Description
Returns the 20 most recent mentions (tweets containing a users's @screen_name) for the authenticating user. The timeline returned is the equivalent of the one seen when you view your mentions on twitter.com. This method can only return up to 800 tweets.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- trim_user (string )
  When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical ID. Omit this parameter to receive the complete user object.
- count (integer )
  Specifies the number of tweets to try and retrieve, up to a maximum of 200. The value of count is best thought of as a limit to the number of tweets to return because suspended or deleted content is removed after the count has been applied. We include retweets in the count, even if include_rts is not supplied. It is recommended you always send include_rts=1 when using this API method.
- since_id (integer )
  Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occured since the since_id, the since_id will be forced to the oldest ID available.
- max_id (integer )
  Returns results with an ID less than (that is, older than) or equal to the specified ID.
- contributor_details (string )
  This parameter enhances the contributors element of the status response to include the screen_name of the contributor. By default only the user_id of the contributor is included.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Mon Sep 03 13:24:14 +0000 2012", "id_str": "242613977966850048", "entities": { "urls": [], "hashtags": [], "user_mentions": [ { "name": "Jason Costa", "id_str": "14927800", "id": 14927800, "indices": [ 0, 11 ], "screen_name": "jasoncosta" }, { "name": "Matt Harris", "id_str": "777925", "id": 777925, "indices": [ 12, 26 ], "screen_name": "themattharris" }, { "name": "ThinkWall", "id_str": "117426578", "id": 117426578, "indices": [ 109, 119 ], "screen_name": "thinkwall" } ] }, "in_reply_to_user_id_str": "14927800", "contributors": null, "text": "@jasoncosta @themattharris Hey! Going to be in Frisco in October. Was hoping to have a meeting to talk about @thinkwall if you're around?", "retweet_count": 0, "in_reply_to_status_id_str": null, "id": 242613977966850050, "geo": null, "retweeted": false, "in_reply_to_user_id": 14927800, "place": null, "user": { "profile_sidebar_fill_color": "EEEEEE", "profile_sidebar_border_color": "000000", "profile_background_tile": false, "name": "Andrew Spode Miller", "profile_image_url": "http://a0.twimg.com/profile_images/1227466231/spode-balloon-medium_normal.jpg", "created_at": "Mon Sep 22 13:12:01 +0000 2008", "location": "London via Gravesend", "follow_request_sent": false, "profile_link_color": "F31B52", "is_translator": false, "id_str": "16402947", "entities": { "url": { "urls": [ { "expanded_url": null, "url": "http://www.linkedin.com/in/spode", "indices": [ 0, 32 ] } ] }, "description": { "urls": [] } }, "default_profile": false, "contributors_enabled": false, "favourites_count": 16, "url": "http://www.linkedin.com/in/spode", "profile_image_url_https": "https://si0.twimg.com/profile_images/1227466231/spode-balloon-medium_normal.jpg", "utc_offset": 0, "id": 16402947, "profile_use_background_image": false, "listed_count": 129, "profile_text_color": "262626", "lang": "en", "followers_count": 2013, "protected": false, "notifications": null, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/16420220/twitter-background-final.png", "profile_background_color": "FFFFFF", "verified": false, "geo_enabled": true, "time_zone": "London", "description": "Co-Founder/Dev (PHP/jQuery) @justFDI. Run @thinkbikes and @thinkwall for events. Ex tech journo, helps run @uktjpr. Passion for Linux and customises everything.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/16420220/twitter-background-final.png", "statuses_count": 11550, "friends_count": 770, "following": null, "show_all_inline_media": true, "screen_name": "spode" }, "in_reply_to_screen_name": "jasoncosta", "source": "<a href=\"http://www.journotwit.com\" rel=\"nofollow\">JournoTwit</a>", "in_reply_to_status_id": null }, { "coordinates": { "coordinates": [ 121.0132101, 14.5191613 ], "type": "Point" }, "favorited": false, "truncated": false, "created_at": "Mon Sep 03 08:08:02 +0000 2012", "id_str": "242534402280783873", "entities": { "urls": [], "hashtags": [ { "text": "twitter", "indices": [ 49, 57 ] } ], "user_mentions": [ { "name": "Jason Costa", "id_str": "14927800", "id": 14927800, "indices": [ 14, 25 ], "screen_name": "jasoncosta" } ] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "Got the shirt @jasoncosta thanks man! Loving the #twitter bird on the shirt :-)", "retweet_count": 0, "in_reply_to_status_id_str": null, "id": 242534402280783870, "geo": { "coordinates": [ 14.5191613, 121.0132101 ], "type": "Point" }, "retweeted": false, "in_reply_to_user_id": null, "place": null, "user": { "profile_sidebar_fill_color": "EFEFEF", "profile_sidebar_border_color": "EEEEEE", "profile_background_tile": true, "name": "Mikey", "profile_image_url": "http://a0.twimg.com/profile_images/1305509670/chatMikeTwitter_normal.png", "created_at": "Fri Jun 20 15:57:08 +0000 2008", "location": "Singapore", "follow_request_sent": false, "profile_link_color": "009999", "is_translator": false, "id_str": "15181205", "entities": { "url": { "urls": [ { "expanded_url": null, "url": "http://about.me/michaelangelo", "indices": [ 0, 29 ] } ] }, "description": { "urls": [] } }, "default_profile": false, "contributors_enabled": false, "favourites_count": 11, "url": "http://about.me/michaelangelo", "profile_image_url_https": "https://si0.twimg.com/profile_images/1305509670/chatMikeTwitter_normal.png", "utc_offset": 28800, "id": 15181205, "profile_use_background_image": true, "listed_count": 61, "profile_text_color": "333333", "lang": "en", "followers_count": 577, "protected": false, "notifications": null, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme14/bg.gif", "profile_background_color": "131516", "verified": false, "geo_enabled": true, "time_zone": "Hong Kong", "description": "Android Applications Developer, Studying Martial Arts, Plays MTG, Food and movie junkie", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme14/bg.gif", "statuses_count": 11327, "friends_count": 138, "following": null, "show_all_inline_media": true, "screen_name": "mikedroid" }, "in_reply_to_screen_name": null, "source": "<a href=\"http://twitter.com/download/android\" rel=\"nofollow\">Twitter for Android</a>", "in_reply_to_status_id": null } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /statuses/user_timeline{mediaTypeExtension}
GET

#### statuses user_timeline{mediaTypeExtension}

GET
/statuses/user_timeline{mediaTypeExtension}
Description
Returns a collection of the most recent Tweets posted by the user indicated by the screen_name or user_id parameters. User timelines belonging to protected users may only be requested when the authenticated user either "owns" the timeline or is an approved follower of the owner. The timeline returned is the equivalent of the one seen when you view a user's profile on twitter.com. This method can only return up to 3,200 of a user's most recent Tweets. Native retweets of other statuses by the user is included in this total, regardless of whether include_rts is set to false when requesting this resource.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- trim_user (string )
  When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical ID. Omit this parameter to receive the complete user object.
- user_id (integer )
  The ID of the user for whom to return results for.
- screen_name (string )
  The screen name of the user for whom to return results for.
- since_id (integer )
  Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occured since the since_id, the since_id will be forced to the oldest ID available.
- count (integer )
  Specifies the number of tweets to try and retrieve, up to a maximum of 200 per distinct request. The value of count is best thought of as a limit to the number of tweets to return because suspended or deleted content is removed after the count has been applied. We include retweets in the count, even if include_rts is not supplied. It is recommended you always send include_rts=1 when using this API method.
- max_id (integer )
  Returns results with an ID less than (that is, older than) or equal to the specified ID.
- contributor_details (string )
  This parameter enhances the contributors element of the status response to include the screen_name of the contributor. By default only the user_id of the contributor is included.
- exclude_replies (string )
  This parameter will prevent replies from appearing in the returned timeline. Using exclude_replies with the count parameter will mean you will receive up-to count tweets - this is because the count parameter retrieves that many tweets before filtering out retweets and replies. This parameter is only supported for JSON and XML responses.
- include_rts (string )
  When set to false, the timeline will strip any native retweets (though they will still count toward both the maximal length of the timeline and the slice selected by the count parameter). Note: If you're using the trim_user parameter in conjunction with include_rts, the retweets will still contain a full user object.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Wed Aug 29 17:12:58 +0000 2012", "id_str": "240859602684612608", "entities": { "urls": [ { "expanded_url": "https://dev.twitter.com/blog/twitter-certified-products", "url": "https://t.co/MjJ8xAnT", "indices": [ 52, 73 ], "display_url": "dev.twitter.com/blog/twitter-c..." } ], "hashtags": [], "user_mentions": [] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "Introducing the Twitter Certified Products Program: https://t.co/MjJ8xAnT", "retweet_count": 121, "in_reply_to_status_id_str": null, "id": 240859602684612600, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "user": { "profile_sidebar_fill_color": "DDEEF6", "profile_sidebar_border_color": "C0DEED", "profile_background_tile": false, "name": "Twitter API", "profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "created_at": "Wed May 23 06:01:13 +0000 2007", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": false, "id_str": "6253282", "entities": { "url": { "urls": [ { "expanded_url": null, "url": "http://dev.twitter.com", "indices": [ 0, 22 ] } ] }, "description": { "urls": [] } }, "default_profile": true, "contributors_enabled": true, "favourites_count": 24, "url": "http://dev.twitter.com", "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "utc_offset": -28800, "id": 6253282, "profile_use_background_image": true, "listed_count": 10775, "profile_text_color": "333333", "lang": "en", "followers_count": 1212864, "protected": false, "notifications": null, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "profile_background_color": "C0DEED", "verified": true, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "statuses_count": 3333, "friends_count": 31, "following": null, "show_all_inline_media": false, "screen_name": "twitterapi" }, "in_reply_to_screen_name": null, "source": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>", "in_reply_to_status_id": null }, { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Sat Aug 25 17:26:51 +0000 2012", "id_str": "239413543487819778", "entities": { "urls": [ { "expanded_url": "https://dev.twitter.com/issues/485", "url": "https://t.co/p5bOzH0k", "indices": [ 97, 118 ], "display_url": "dev.twitter.com/issues/485" } ], "hashtags": [], "user_mentions": [] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "We are working to resolve issues with application management &amp; logging in to the dev portal: https://t.co/p5bOzH0k ^TS", "retweet_count": 105, "in_reply_to_status_id_str": null, "id": 239413543487819780, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "user": { "profile_sidebar_fill_color": "DDEEF6", "profile_sidebar_border_color": "C0DEED", "profile_background_tile": false, "name": "Twitter API", "profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "created_at": "Wed May 23 06:01:13 +0000 2007", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": false, "id_str": "6253282", "entities": { "url": { "urls": [ { "expanded_url": null, "url": "http://dev.twitter.com", "indices": [ 0, 22 ] } ] }, "description": { "urls": [] } }, "default_profile": true, "contributors_enabled": true, "favourites_count": 24, "url": "http://dev.twitter.com", "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "utc_offset": -28800, "id": 6253282, "profile_use_background_image": true, "listed_count": 10775, "profile_text_color": "333333", "lang": "en", "followers_count": 1212864, "protected": false, "notifications": null, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "profile_background_color": "C0DEED", "verified": true, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "statuses_count": 3333, "friends_count": 31, "following": null, "show_all_inline_media": false, "screen_name": "twitterapi" }, "in_reply_to_screen_name": null, "source": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>", "in_reply_to_status_id": null } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /statuses/home_timeline{mediaTypeExtension}
GET

#### statuses home_timeline{mediaTypeExtension}

GET
/statuses/home_timeline{mediaTypeExtension}
Description
Returns a collection of the most recent Tweets and retweets posted by the authenticating user and the users they follow. The home timeline is central to how most users interact with the Twitter service. Up to 800 Tweets are obtainable on the home timeline. It is more volatile for users that follow many users or follow users who tweet frequently. See Working with Timelines for instructions on traversing timelines efficiently.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- trim_user (string )
  When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical ID. Omit this parameter to receive the complete user object.
- count (integer )
  Specifies the number of records to retrieve. Must be less than or equal to 200.
- since_id (integer )
  Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occured since the since_id, the since_id will be forced to the oldest ID available.
- max_id (integer )
  Returns results with an ID less than (that is, older than) or equal to the specified ID.
- exclude_replies (string )
  This parameter will prevent replies from appearing in the returned timeline. Using exclude_replies with the count parameter will mean you will receive up-to count tweets - this is because the count parameter retrieves that many tweets before filtering out retweets and replies. This parameter is only supported for JSON and XML responses.
- contributor_details (string )
  This parameter enhances the contributors element of the status response to include the screen_name of the contributor. By default only the user_id of the contributor is included.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "coordinates": null, "truncated": false, "created_at": "Tue Aug 28 21:16:23 +0000 2012", "favorited": false, "id_str": "240558470661799936", "in_reply_to_user_id_str": null, "entities": { "urls": [], "hashtags": [], "user_mentions": [] }, "text": "just another test", "contributors": null, "id": 240558470661799940, "retweet_count": 0, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "place": null, "source": "<a href=\"http://realitytechnicians.com\" rel=\"nofollow\">OAuth Dancer Reborn</a>", "user": { "name": "OAuth Dancer", "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": true, "profile_sidebar_border_color": "C0DEED", "profile_image_url": "http://a0.twimg.com/profile_images/730275945/oauth-dancer_normal.jpg", "created_at": "Wed Mar 03 19:37:35 +0000 2010", "location": "San Francisco, CA", "follow_request_sent": false, "id_str": "119476949", "is_translator": false, "profile_link_color": "0084B4", "entities": { "url": { "urls": [ { "expanded_url": null, "url": "http://bit.ly/oauth-dancer", "indices": [ 0, 26 ], "display_url": null } ] }, "description": null }, "default_profile": false, "url": "http://bit.ly/oauth-dancer", "contributors_enabled": false, "favourites_count": 7, "utc_offset": null, "profile_image_url_https": "https://si0.twimg.com/profile_images/730275945/oauth-dancer_normal.jpg", "id": 119476949, "listed_count": 1, "profile_use_background_image": true, "profile_text_color": "333333", "followers_count": 28, "lang": "en", "protected": false, "geo_enabled": true, "notifications": false, "description": "", "profile_background_color": "C0DEED", "verified": false, "time_zone": null, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/80151733/oauth-dance.png", "statuses_count": 166, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/80151733/oauth-dance.png", "default_profile_image": false, "friends_count": 14, "following": false, "show_all_inline_media": false, "screen_name": "oauth_dancer" }, "in_reply_to_screen_name": null, "in_reply_to_status_id": null }, { "coordinates": { "coordinates": [ -122.25831, 37.871609 ], "type": "Point" }, "truncated": false, "created_at": "Tue Aug 28 21:08:15 +0000 2012", "favorited": false, "id_str": "240556426106372096", "in_reply_to_user_id_str": null, "entities": { "urls": [ { "expanded_url": "http://blogs.ischool.berkeley.edu/i290-abdt-s12/", "url": "http://t.co/bfj7zkDJ", "indices": [ 79, 99 ], "display_url": "blogs.ischool.berkeley.edu/i290-abdt-s12/" } ], "hashtags": [], "user_mentions": [ { "name": "Cal", "id_str": "17445752", "id": 17445752, "indices": [ 60, 64 ], "screen_name": "Cal" }, { "name": "Othman Laraki", "id_str": "20495814", "id": 20495814, "indices": [ 70, 77 ], "screen_name": "othman" } ] }, "text": "lecturing at the \"analyzing big data with twitter\" class at @cal with @othman http://t.co/bfj7zkDJ", "contributors": null, "id": 240556426106372100, "retweet_count": 3, "in_reply_to_status_id_str": null, "geo": { "coordinates": [ 37.871609, -122.25831 ], "type": "Point" }, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": { "name": "Berkeley", "country_code": "US", "country": "United States", "attributes": {}, "url": "http://api.twitter.com/1/geo/id/5ef5b7f391e30aff.json", "id": "5ef5b7f391e30aff", "bounding_box": { "coordinates": [ [ [ -122.367781, 37.835727 ], [ -122.234185, 37.835727 ], [ -122.234185, 37.905824 ], [ -122.367781, 37.905824 ] ] ], "type": "Polygon" }, "full_name": "Berkeley, CA", "place_type": "city" }, "source": "<a href=\"http://www.apple.com\" rel=\"nofollow\">Safari on iOS</a>", "user": { "name": "Raffi Krikorian", "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": false, "profile_sidebar_border_color": "C0DEED", "profile_image_url": "http://a0.twimg.com/profile_images/1270234259/raffi-headshot-casual_normal.png", "created_at": "Sun Aug 19 14:24:06 +0000 2007", "location": "San Francisco, California", "follow_request_sent": false, "id_str": "8285392", "is_translator": false, "profile_link_color": "0084B4", "entities": { "url": { "urls": [ { "expanded_url": "http://about.me/raffi.krikorian", "url": "http://t.co/eNmnM6q", "indices": [ 0, 19 ], "display_url": "about.me/raffi.krikorian" } ] }, "description": { "urls": [] } }, "default_profile": true, "url": "http://t.co/eNmnM6q", "contributors_enabled": false, "favourites_count": 724, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/1270234259/raffi-headshot-casual_normal.png", "id": 8285392, "listed_count": 619, "profile_use_background_image": true, "profile_text_color": "333333", "followers_count": 18752, "lang": "en", "protected": false, "geo_enabled": true, "notifications": false, "description": "Director of @twittereng's Platform Services. I break things.", "profile_background_color": "C0DEED", "verified": false, "time_zone": "Pacific Time (US & Canada)", "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "statuses_count": 5007, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "default_profile_image": false, "friends_count": 701, "following": true, "show_all_inline_media": true, "screen_name": "raffi" }, "in_reply_to_screen_name": null, "in_reply_to_status_id": null }, { "coordinates": null, "truncated": false, "created_at": "Tue Aug 28 19:59:34 +0000 2012", "favorited": false, "id_str": "240539141056638977", "in_reply_to_user_id_str": null, "entities": { "urls": [], "hashtags": [], "user_mentions": [] }, "text": "You'd be right more often if you thought you were wrong.", "contributors": null, "id": 240539141056638980, "retweet_count": 1, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "place": null, "source": "web", "user": { "name": "Taylor Singletary", "profile_sidebar_fill_color": "FBFBFB", "profile_background_tile": true, "profile_sidebar_border_color": "000000", "profile_image_url": "http://a0.twimg.com/profile_images/2546730059/f6a8zq58mg1hn0ha8vie_normal.jpeg", "created_at": "Wed Mar 07 22:23:19 +0000 2007", "location": "San Francisco, CA", "follow_request_sent": false, "id_str": "819797", "is_translator": false, "profile_link_color": "c71818", "entities": { "url": { "urls": [ { "expanded_url": "http://www.rebelmouse.com/episod/", "url": "http://t.co/Lxw7upbN", "indices": [ 0, 20 ], "display_url": "rebelmouse.com/episod/" } ] }, "description": { "urls": [] } }, "default_profile": false, "url": "http://t.co/Lxw7upbN", "contributors_enabled": false, "favourites_count": 15990, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/2546730059/f6a8zq58mg1hn0ha8vie_normal.jpeg", "id": 819797, "listed_count": 340, "profile_use_background_image": true, "profile_text_color": "D20909", "followers_count": 7126, "lang": "en", "protected": false, "geo_enabled": true, "notifications": false, "description": "Reality Technician, Twitter API team, synthesizer enthusiast; a most excellent adventure in timelines. I know it's hard to believe in something you can't see.", "profile_background_color": "000000", "verified": false, "time_zone": "Pacific Time (US & Canada)", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/643655842/hzfv12wini4q60zzrthg.png", "statuses_count": 18076, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/643655842/hzfv12wini4q60zzrthg.png", "default_profile_image": false, "friends_count": 5444, "following": true, "show_all_inline_media": true, "screen_name": "episod" }, "in_reply_to_screen_name": null, "in_reply_to_status_id": null } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /statuses/retweets_of_me{mediaTypeExtension}
GET

#### statuses retweets_of_me{mediaTypeExtension}

GET
/statuses/retweets_of_me{mediaTypeExtension}
Description
Returns the most recent tweets authored by the authenticating user that have been retweeted by others. This timeline is a subset of the user's GET statuses/user_timeline.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- trim_user (string )
  When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical ID. Omit this parameter to receive the complete user object.
- count (integer )
  Specifies the number of records to retrieve. Must be less than or equal to 100. If omitted, 20 will be assumed.
- since_id (integer )
  Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occured since the since_id, the since_id will be forced to the oldest ID available.
- max_id (integer )
  Returns results with an ID less than (that is, older than) or equal to the specified ID.
- include_user_entities (string )
  The user entities node will be disincluded when set to false.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "coordinates": null, "truncated": false, "favorited": false, "created_at": "Fri Oct 19 15:51:49 +0000 2012", "id_str": "259320959964680192", "entities": { "urls": [], "hashtags": [], "user_mentions": [] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "It's bring your migraine to work day today!", "in_reply_to_status_id_str": null, "id": 259320959964680200, "retweet_count": 1, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "source": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>", "user": { "name": "Taylor Singletary", "profile_sidebar_fill_color": "FBFBFB", "profile_background_tile": false, "profile_sidebar_border_color": "000000", "location": "San Francisco, CA", "profile_image_url": "http://a0.twimg.com/profile_images/2766969649/5e1a50995a9f9bfcdcdc7503e1271422_normal.jpeg", "created_at": "Wed Mar 07 22:23:19 +0000 2007", "profile_link_color": "CC1442", "is_translator": false, "id_str": "819797", "follow_request_sent": false, "entities": { "url": { "urls": [ { "expanded_url": "http://soundcloud.com/reality-technician", "url": "http://t.co/bKlJ80Do", "indices": [ 0, 20 ], "display_url": "soundcloud.com/reality-techni..." } ] }, "description": { "urls": [] } }, "favourites_count": 17094, "url": "http://t.co/bKlJ80Do", "contributors_enabled": false, "default_profile": false, "profile_image_url_https": "https://si0.twimg.com/profile_images/2766969649/5e1a50995a9f9bfcdcdc7503e1271422_normal.jpeg", "profile_banner_url": "https://si0.twimg.com/profile_banners/819797/1351262715", "utc_offset": -28800, "id": 819797, "profile_use_background_image": false, "listed_count": 351, "followers_count": 7701, "profile_text_color": "D20909", "protected": false, "lang": "en", "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "notifications": false, "profile_background_color": "6B0F0F", "description": "Reality Technician, Twitter API team, synth enthusiast. A most excellent adventure in timelines. Through the darkness of future past, the magician longs to see.", "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/686878932/6447abb9f83c76fb4fbd68e626c6c8c1.png", "friends_count": 5549, "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/686878932/6447abb9f83c76fb4fbd68e626c6c8c1.png", "statuses_count": 18626, "screen_name": "episod", "following": false }, "place": null, "in_reply_to_screen_name": null, "in_reply_to_status_id": null } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /statuses/retweets/{id}{mediaTypeExtension}
GET

#### statuses retweets {id}{mediaTypeExtension}

GET
/statuses/retweets/{id}{mediaTypeExtension}
Description
Returns a collection of the 100 most recent retweets of the tweet specified by the id parameter.

#### Request

##### Uri Parameters

- id (integer )
  The numerical ID of the desired status.
- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- trim_user (string )
  When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical ID. Omit this parameter to receive the complete user object.
- count (integer )
  Specifies the number of records to retrieve. Must be less than or equal to 100.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "coordinates": null, "created_at": "Mon Mar 05 18:31:56 +0000 2012", "favorited": false, "truncated": false, "retweeted_status": { "coordinates": null, "created_at": "Mon Jan 03 15:15:36 +0000 2011", "favorited": false, "truncated": false, "id_str": "21947795900469248", "in_reply_to_user_id_str": null, "entities": { "urls": [], "media": [], "hashtags": [], "user_mentions": [] }, "text": "It's 2011. I work at Twitter. And so let's go kick some ass.", "contributors": null, "id": 21947795900469250, "retweet_count": 4, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "source": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>", "in_reply_to_screen_name": null, "user": { "profile_sidebar_border_color": "000000", "name": "Taylor Singletary", "profile_sidebar_fill_color": "FBFBFB", "profile_background_tile": true, "created_at": "Wed Mar 07 22:23:19 +0000 2007", "profile_image_url": "http://a0.twimg.com/profile_images/2596092158/afpecvf41m8f0juql78p_normal.png", "location": "San Francisco, CA", "follow_request_sent": false, "is_translator": false, "id_str": "819797", "profile_link_color": "C71818", "entities": { "url": { "urls": [ { "expanded_url": "http://t.co/Lxw7upbN", "url": "http://t.co/Lxw7upbN", "indices": [ 0, 20 ], "display_url": "t.co/Lxw7upbN" } ] }, "description": { "urls": [] } }, "url": "http://t.co/Lxw7upbN", "default_profile": false, "contributors_enabled": false, "favourites_count": 16148, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/2596092158/afpecvf41m8f0juql78p_normal.png", "id": 819797, "listed_count": 340, "profile_use_background_image": true, "profile_text_color": "D20909", "protected": false, "lang": "en", "followers_count": 7235, "geo_enabled": true, "verified": false, "notifications": false, "description": "Reality Technician, Twitter API team, synth enthusiast. A most excellent adventure in timelines. Namenandclaimen.", "profile_background_color": "000000", "time_zone": "Pacific Time (US & Canada)", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/643655842/hzfv12wini4q60zzrthg.png", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/643655842/hzfv12wini4q60zzrthg.png", "statuses_count": 18189, "default_profile_image": false, "friends_count": 5456, "show_all_inline_media": true, "screen_name": "episod", "following": false }, "place": null, "in_reply_to_status_id": null }, "id_str": "176736821278019585", "in_reply_to_user_id_str": null, "entities": { "urls": [], "media": [], "hashtags": [], "user_mentions": [ { "name": "Taylor Singletary", "id_str": "819797", "id": 819797, "indices": [ 3, 10 ], "screen_name": "episod" } ] }, "text": "RT @episod: It's 2011. I work at Twitter. And so let's go kick some ass.", "contributors": null, "id": 176736821278019600, "retweet_count": 4, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "source": "web", "in_reply_to_screen_name": null, "user": { "profile_sidebar_border_color": "C0DEED", "name": "Haodong Yang", "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": false, "created_at": "Tue Sep 27 19:48:49 +0000 2011", "profile_image_url": "http://a0.twimg.com/profile_images/1629930876/DD2_11_normal.jpg", "location": "Philly, PA", "follow_request_sent": false, "is_translator": false, "id_str": "381124736", "profile_link_color": "0084B4", "entities": { "description": { "urls": [] } }, "url": null, "default_profile": true, "contributors_enabled": false, "favourites_count": 0, "utc_offset": -18000, "profile_image_url_https": "https://si0.twimg.com/profile_images/1629930876/DD2_11_normal.jpg", "id": 381124736, "listed_count": 0, "profile_use_background_image": true, "profile_text_color": "333333", "protected": false, "lang": "en", "followers_count": 4, "geo_enabled": false, "verified": false, "notifications": false, "description": "", "profile_background_color": "C0DEED", "time_zone": "Quito", "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "statuses_count": 50, "default_profile_image": false, "friends_count": 15, "show_all_inline_media": false, "screen_name": "HaodongYang2ll", "following": false }, "place": null, "in_reply_to_status_id": null }, { "coordinates": null, "created_at": "Wed Jan 18 00:12:16 +0000 2012", "favorited": false, "truncated": false, "retweeted_status": { "coordinates": null, "created_at": "Mon Jan 03 15:15:36 +0000 2011", "favorited": false, "truncated": false, "id_str": "21947795900469248", "in_reply_to_user_id_str": null, "entities": { "urls": [], "media": [], "hashtags": [], "user_mentions": [] }, "text": "It's 2011. I work at Twitter. And so let's go kick some ass.", "contributors": null, "id": 21947795900469250, "retweet_count": 4, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "source": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>", "in_reply_to_screen_name": null, "user": { "profile_sidebar_border_color": "000000", "name": "Taylor Singletary", "profile_sidebar_fill_color": "FBFBFB", "profile_background_tile": true, "created_at": "Wed Mar 07 22:23:19 +0000 2007", "profile_image_url": "http://a0.twimg.com/profile_images/2596092158/afpecvf41m8f0juql78p_normal.png", "location": "San Francisco, CA", "follow_request_sent": false, "is_translator": false, "id_str": "819797", "profile_link_color": "C71818", "entities": { "url": { "urls": [ { "expanded_url": "http://t.co/Lxw7upbN", "url": "http://t.co/Lxw7upbN", "indices": [ 0, 20 ], "display_url": "t.co/Lxw7upbN" } ] }, "description": { "urls": [] } }, "url": "http://t.co/Lxw7upbN", "default_profile": false, "contributors_enabled": false, "favourites_count": 16148, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/2596092158/afpecvf41m8f0juql78p_normal.png", "id": 819797, "listed_count": 340, "profile_use_background_image": true, "profile_text_color": "D20909", "protected": false, "lang": "en", "followers_count": 7235, "geo_enabled": true, "verified": false, "notifications": false, "description": "Reality Technician, Twitter API team, synth enthusiast. A most excellent adventure in timelines. Namenandclaimen.", "profile_background_color": "000000", "time_zone": "Pacific Time (US & Canada)", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/643655842/hzfv12wini4q60zzrthg.png", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/643655842/hzfv12wini4q60zzrthg.png", "statuses_count": 18189, "default_profile_image": false, "friends_count": 5456, "show_all_inline_media": true, "screen_name": "episod", "following": false }, "place": null, "in_reply_to_status_id": null }, "id_str": "159427850091499521", "in_reply_to_user_id_str": null, "entities": { "urls": [], "media": [], "hashtags": [], "user_mentions": [ { "name": "Taylor Singletary", "id_str": "819797", "id": 819797, "indices": [ 3, 10 ], "screen_name": "episod" } ] }, "text": "RT @episod: It's 2011. I work at Twitter. And so let's go kick some ass.", "contributors": null, "id": 159427850091499520, "retweet_count": 4, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "source": "web", "in_reply_to_screen_name": null, "user": { "profile_sidebar_border_color": "DDDDDD", "name": "Jed Sundwall", "profile_sidebar_fill_color": "EEEEEE", "profile_background_tile": false, "created_at": "Tue May 01 17:44:32 +0000 2007", "profile_image_url": "http://a0.twimg.com/profile_images/2349550745/545z8g5d160mrg46ia78_normal.jpeg", "location": "San Diego", "follow_request_sent": false, "is_translator": false, "id_str": "5689832", "profile_link_color": "003366", "entities": { "url": { "urls": [ { "expanded_url": null, "url": "http://measuredvoice.com", "indices": [ 0, 24 ], "display_url": null } ] }, "description": { "urls": [] } }, "url": "http://measuredvoice.com", "default_profile": false, "contributors_enabled": false, "favourites_count": 1379, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/2349550745/545z8g5d160mrg46ia78_normal.jpeg", "id": 5689832, "listed_count": 102, "profile_use_background_image": false, "profile_text_color": "222222", "protected": false, "lang": "en", "followers_count": 1393, "geo_enabled": true, "verified": false, "notifications": false, "description": "Dad. CEO of @MeasuredVoice. \"Normally, I'm against big things. I think the world's going to be solved by millions of small things.\" - Pete Seeger", "profile_background_color": "FFFFFF", "time_zone": "Pacific Time (US & Canada)", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/134971286/twitter-template.png", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/134971286/twitter-template.png", "statuses_count": 9134, "default_profile_image": false, "friends_count": 293, "show_all_inline_media": true, "screen_name": "jedsundwall", "following": true }, "place": null, "in_reply_to_status_id": null }, { "coordinates": null, "created_at": "Tue Jan 10 05:31:38 +0000 2012", "favorited": false, "truncated": false, "retweeted_status": { "coordinates": null, "created_at": "Mon Jan 03 15:15:36 +0000 2011", "favorited": false, "truncated": false, "id_str": "21947795900469248", "in_reply_to_user_id_str": null, "entities": { "urls": [], "media": [], "hashtags": [], "user_mentions": [] }, "text": "It's 2011. I work at Twitter. And so let's go kick some ass.", "contributors": null, "id": 21947795900469250, "retweet_count": 4, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "source": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>", "in_reply_to_screen_name": null, "user": { "profile_sidebar_border_color": "000000", "name": "Taylor Singletary", "profile_sidebar_fill_color": "FBFBFB", "profile_background_tile": true, "created_at": "Wed Mar 07 22:23:19 +0000 2007", "profile_image_url": "http://a0.twimg.com/profile_images/2596092158/afpecvf41m8f0juql78p_normal.png", "location": "San Francisco, CA", "follow_request_sent": false, "is_translator": false, "id_str": "819797", "profile_link_color": "C71818", "entities": { "url": { "urls": [ { "expanded_url": "http://t.co/Lxw7upbN", "url": "http://t.co/Lxw7upbN", "indices": [ 0, 20 ], "display_url": "t.co/Lxw7upbN" } ] }, "description": { "urls": [] } }, "url": "http://t.co/Lxw7upbN", "default_profile": false, "contributors_enabled": false, "favourites_count": 16148, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/2596092158/afpecvf41m8f0juql78p_normal.png", "id": 819797, "listed_count": 340, "profile_use_background_image": true, "profile_text_color": "D20909", "protected": false, "lang": "en", "followers_count": 7235, "geo_enabled": true, "verified": false, "notifications": false, "description": "Reality Technician, Twitter API team, synth enthusiast. A most excellent adventure in timelines. Namenandclaimen.", "profile_background_color": "000000", "time_zone": "Pacific Time (US & Canada)", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/643655842/hzfv12wini4q60zzrthg.png", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/643655842/hzfv12wini4q60zzrthg.png", "statuses_count": 18189, "default_profile_image": false, "friends_count": 5456, "show_all_inline_media": true, "screen_name": "episod", "following": false }, "place": null, "in_reply_to_status_id": null }, "id_str": "156609121603432448", "in_reply_to_user_id_str": null, "entities": { "urls": [], "media": [], "hashtags": [], "user_mentions": [ { "name": "Taylor Singletary", "id_str": "819797", "id": 819797, "indices": [ 3, 10 ], "screen_name": "episod" } ] }, "text": "RT @episod: It's 2011. I work at Twitter. And so let's go kick some ass.", "contributors": null, "id": 156609121603432450, "retweet_count": 4, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "source": "<a href=\"http://hugeflow.com\" rel=\"nofollow\">Morning Brief</a>", "in_reply_to_screen_name": null, "user": { "profile_sidebar_border_color": "C0DEED", "name": "SEUNGMAN KIM", "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": false, "created_at": "Tue Jun 08 15:50:31 +0000 2010", "profile_image_url": "http://a0.twimg.com/profile_images/1694740268/image_normal", "location": "", "follow_request_sent": false, "is_translator": false, "id_str": "153449734", "profile_link_color": "0084B4", "entities": { "description": { "urls": [] } }, "url": null, "default_profile": true, "contributors_enabled": false, "favourites_count": 0, "utc_offset": -36000, "profile_image_url_https": "https://si0.twimg.com/profile_images/1694740268/image_normal", "id": 153449734, "listed_count": 0, "profile_use_background_image": true, "profile_text_color": "333333", "protected": false, "lang": "en", "followers_count": 2, "geo_enabled": false, "verified": false, "notifications": false, "description": "", "profile_background_color": "C0DEED", "time_zone": "Hawaii", "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "statuses_count": 36, "default_profile_image": false, "friends_count": 3, "show_all_inline_media": false, "screen_name": "MrGoldsman", "following": false }, "place": null, "in_reply_to_status_id": null }, { "coordinates": null, "created_at": "Mon Jan 03 15:17:31 +0000 2011", "favorited": false, "truncated": false, "retweeted_status": { "coordinates": null, "created_at": "Mon Jan 03 15:15:36 +0000 2011", "favorited": false, "truncated": false, "id_str": "21947795900469248", "in_reply_to_user_id_str": null, "entities": { "urls": [], "media": [], "hashtags": [], "user_mentions": [] }, "text": "It's 2011. I work at Twitter. And so let's go kick some ass.", "contributors": null, "id": 21947795900469250, "retweet_count": 4, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "source": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>", "in_reply_to_screen_name": null, "user": { "profile_sidebar_border_color": "000000", "name": "Taylor Singletary", "profile_sidebar_fill_color": "FBFBFB", "profile_background_tile": true, "created_at": "Wed Mar 07 22:23:19 +0000 2007", "profile_image_url": "http://a0.twimg.com/profile_images/2596092158/afpecvf41m8f0juql78p_normal.png", "location": "San Francisco, CA", "follow_request_sent": false, "is_translator": false, "id_str": "819797", "profile_link_color": "C71818", "entities": { "url": { "urls": [ { "expanded_url": "http://t.co/Lxw7upbN", "url": "http://t.co/Lxw7upbN", "indices": [ 0, 20 ], "display_url": "t.co/Lxw7upbN" } ] }, "description": { "urls": [] } }, "url": "http://t.co/Lxw7upbN", "default_profile": false, "contributors_enabled": false, "favourites_count": 16148, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/2596092158/afpecvf41m8f0juql78p_normal.png", "id": 819797, "listed_count": 340, "profile_use_background_image": true, "profile_text_color": "D20909", "protected": false, "lang": "en", "followers_count": 7235, "geo_enabled": true, "verified": false, "notifications": false, "description": "Reality Technician, Twitter API team, synth enthusiast. A most excellent adventure in timelines. Namenandclaimen.", "profile_background_color": "000000", "time_zone": "Pacific Time (US & Canada)", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/643655842/hzfv12wini4q60zzrthg.png", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/643655842/hzfv12wini4q60zzrthg.png", "statuses_count": 18189, "default_profile_image": false, "friends_count": 5456, "show_all_inline_media": true, "screen_name": "episod", "following": false }, "place": null, "in_reply_to_status_id": null }, "id_str": "21948274806095872", "in_reply_to_user_id_str": null, "entities": { "urls": [], "media": [], "hashtags": [], "user_mentions": [ { "name": "Taylor Singletary", "id_str": "819797", "id": 819797, "indices": [ 3, 10 ], "screen_name": "episod" } ] }, "text": "RT @episod: It's 2011. I work at Twitter. And so let's go kick some ass.", "contributors": null, "id": 21948274806095870, "retweet_count": 4, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "source": "web", "in_reply_to_screen_name": null, "user": { "profile_sidebar_border_color": "303030", "name": "Keef M", "profile_sidebar_fill_color": "9FBAC9", "profile_background_tile": false, "created_at": "Thu Mar 22 15:35:51 +0000 2007", "profile_image_url": "http://a0.twimg.com/profile_images/1258930645/new-wee-mee_normal.jpg", "location": "London, UK", "follow_request_sent": false, "is_translator": false, "id_str": "1891481", "profile_link_color": "0B57A1", "entities": { "url": { "urls": [ { "expanded_url": null, "url": "http://keefmoon.tumblr.com", "indices": [ 0, 26 ], "display_url": null } ] }, "description": { "urls": [] } }, "url": "http://keefmoon.tumblr.com", "default_profile": false, "contributors_enabled": false, "favourites_count": 1513, "utc_offset": 0, "profile_image_url_https": "https://si0.twimg.com/profile_images/1258930645/new-wee-mee_normal.jpg", "id": 1891481, "listed_count": 59, "profile_use_background_image": true, "profile_text_color": "303030", "protected": false, "lang": "en", "followers_count": 1242, "geo_enabled": true, "verified": false, "notifications": false, "description": "Tech and gadget enthusiast. iOS Developer and Co-founder of @SonarSync", "profile_background_color": "303030", "time_zone": "London", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/64877359/mqglacierlake.br.jpg", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/64877359/mqglacierlake.br.jpg", "statuses_count": 17295, "default_profile_image": false, "friends_count": 1995, "show_all_inline_media": false, "screen_name": "keefmoon", "following": true }, "place": null, "in_reply_to_status_id": null } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /statuses/show/{id}{mediaTypeExtension}
GET

#### statuses show {id}{mediaTypeExtension}

GET
/statuses/show/{id}{mediaTypeExtension}
Description
Returns a single Tweet, specified by the id parameter. The Tweet's author will also be embedded within the tweet. Extended description About Geo If there is no geotag for a status, then there will be an empty <geo/> or "geo" : {}. This can only be populated if the user has used the Geotagging API to send a statuses/update. The JSON response mostly uses conventions laid out in GeoJSON. Unfortunately, the coordinates that Twitter renders are reversed from the GeoJSON specification (GeoJSON specifies a longitude then a latitude, whereas we are currently representing it as a latitude then a longitude). Our JSON renders as: ------------- "geo": { "type":"Point", "coordinates":[37.78029, -122.39697] } Contributors If there are no contributors for a Tweet, then there will be an empty or "contributors" : {}. This field will only be populated if the user has contributors enabled on his or her account -- this is a beta feature that is not yet generally available to all. This object contains an array of user IDs for users who have contributed to this status (an example of a status that has been contributed to is this one). In practice, there is usually only one ID in this array. The JSON renders as such ------------- "contributors":[8285392].

#### Request

##### Uri Parameters

- id (integer )
  The numerical ID of the desired Tweet.
- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- trim_user (string )
  When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical ID. Omit this parameter to receive the complete user object.
- include_my_retweet (string )
  When set to either true, t or 1, any Tweets returned that have been retweeted by the authenticating user will include an additional current_user_retweet node, containing the ID of the source status for the retweet.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Wed Jun 06 20:07:10 +0000 2012", "id_str": "210462857140252672", "entities": { "urls": [ { "expanded_url": "https://dev.twitter.com/terms/display-guidelines", "url": "https://t.co/Ed4omjYs", "indices": [ 76, 97 ], "display_url": "dev.twitter.com/terms/display-..." } ], "hashtags": [ { "text": "Twitterbird", "indices": [ 19, 31 ] } ], "user_mentions": [] }, "in_reply_to_user_id_str": null, "contributors": [ 14927800 ], "text": "Along with our new #Twitterbird, we've also updated our Display Guidelines: https://t.co/Ed4omjYs ^JC", "retweet_count": 66, "in_reply_to_status_id_str": null, "id": 210462857140252670, "geo": null, "retweeted": true, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "user": { "profile_sidebar_fill_color": "DDEEF6", "profile_sidebar_border_color": "C0DEED", "profile_background_tile": false, "name": "Twitter API", "profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "created_at": "Wed May 23 06:01:13 +0000 2007", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": false, "id_str": "6253282", "entities": { "url": { "urls": [ { "expanded_url": null, "url": "http://dev.twitter.com", "indices": [ 0, 22 ] } ] }, "description": { "urls": [] } }, "default_profile": true, "contributors_enabled": true, "favourites_count": 24, "url": "http://dev.twitter.com", "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "utc_offset": -28800, "id": 6253282, "profile_use_background_image": true, "listed_count": 10774, "profile_text_color": "333333", "lang": "en", "followers_count": 1212963, "protected": false, "notifications": null, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "profile_background_color": "C0DEED", "verified": true, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "statuses_count": 3333, "friends_count": 31, "following": true, "show_all_inline_media": false, "screen_name": "twitterapi" }, "in_reply_to_screen_name": null, "source": "web", "in_reply_to_status_id": null }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /statuses/destroy/{id}{mediaTypeExtension}
POST

#### statuses destroy {id}{mediaTypeExtension}

POST
/statuses/destroy/{id}{mediaTypeExtension}
Description
Destroys the status specified by the required ID parameter. The authenticating user must be the author of the specified status. Returns the destroyed status if successful.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.
- id (integer )
  The numerical ID of the desired status.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "coordinates": null, "favorited": false, "created_at": "Wed Aug 29 16:54:38 +0000 2012", "truncated": false, "id_str": "240854986559455234", "entities": { "urls": [ { "expanded_url": "http://venturebeat.com/2012/08/29/vimeo-dropbox/#.UD5JLsYptSs.twitter", "url": "http://t.co/7UlkvZzM", "indices": [ 69, 89 ], "display_url": "venturebeat.com/2012/08/29/vim..." } ], "hashtags": [], "user_mentions": [] }, "in_reply_to_user_id_str": null, "text": "\"Vimeo integrates with Dropbox for easier video uploads and shares\": http://t.co/7UlkvZzM", "contributors": null, "retweet_count": 1, "id": 240854986559455230, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "possibly_sensitive": false, "place": null, "user": { "name": "Jason Costa", "profile_sidebar_border_color": "86A4A6", "profile_sidebar_fill_color": "A0C5C7", "profile_background_tile": false, "profile_image_url": "http://a0.twimg.com/profile_images/1751674923/new_york_beard_normal.jpg", "created_at": "Wed May 28 00:20:15 +0000 2008", "location": "", "is_translator": true, "follow_request_sent": false, "id_str": "14927800", "profile_link_color": "FF3300", "entities": { "url": { "urls": [ { "expanded_url": "http://www.jason-costa.blogspot.com/", "url": "http://t.co/YCA3ZKY", "indices": [ 0, 19 ], "display_url": "jason-costa.blogspot.com" } ] }, "description": { "urls": [] } }, "default_profile": false, "contributors_enabled": false, "url": "http://t.co/YCA3ZKY", "favourites_count": 883, "utc_offset": -28800, "id": 14927800, "profile_image_url_https": "https://si0.twimg.com/profile_images/1751674923/new_york_beard_normal.jpg", "profile_use_background_image": true, "listed_count": 150, "profile_text_color": "333333", "protected": false, "lang": "en", "followers_count": 8760, "time_zone": "Pacific Time (US & Canada)", "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme6/bg.gif", "verified": false, "profile_background_color": "709397", "notifications": false, "description": "Platform at Twitter", "geo_enabled": true, "statuses_count": 5531, "default_profile_image": false, "friends_count": 166, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme6/bg.gif", "show_all_inline_media": true, "screen_name": "jasoncosta", "following": false }, "possibly_sensitive_editable": true, "source": "<a href=\"http://twitter.com/tweetbutton\" rel=\"nofollow\">Tweet Button</a>", "in_reply_to_screen_name": null, "in_reply_to_status_id": null }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /statuses/update{mediaTypeExtension}
POST

#### statuses update{mediaTypeExtension}

POST
/statuses/update{mediaTypeExtension}
Description
Updates the authenticating user's current status, also known as tweeting. To upload an image to accompany the tweet, use `POST statuses/update_with_media`. For each update attempt, the update text is compared with the authenticating user's recent tweets. Any attempt that would result in duplication will be blocked, resulting in a 403 error. Therefore, a user cannot submit the same status twice in a row. While not rate limited by the API a user is limited in the number of tweets they can create at a time. If the number of updates posted by the user reaches the current allowed limit this method will return an HTTP 403 error.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "coordinates": null, "favorited": false, "created_at": "Wed Sep 05 00:37:15 +0000 2012", "truncated": false, "id_str": "243145735212777472", "entities": { "urls": [], "hashtags": [ { "text": "peterfalk", "indices": [ 35, 45 ] } ], "user_mentions": [] }, "in_reply_to_user_id_str": null, "text": "Maybe he'll finally find his keys. #peterfalk", "contributors": null, "retweet_count": 0, "id": 243145735212777470, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "place": null, "user": { "name": "Jason Costa", "profile_sidebar_border_color": "86A4A6", "profile_sidebar_fill_color": "A0C5C7", "profile_background_tile": false, "profile_image_url": "http://a0.twimg.com/profile_images/1751674923/new_york_beard_normal.jpg", "created_at": "Wed May 28 00:20:15 +0000 2008", "location": "", "is_translator": true, "follow_request_sent": false, "id_str": "14927800", "profile_link_color": "FF3300", "entities": { "url": { "urls": [ { "expanded_url": "http://www.jason-costa.blogspot.com/", "url": "http://t.co/YCA3ZKY", "indices": [ 0, 19 ], "display_url": "jason-costa.blogspot.com" } ] }, "description": { "urls": [] } }, "default_profile": false, "contributors_enabled": false, "url": "http://t.co/YCA3ZKY", "favourites_count": 883, "utc_offset": -28800, "id": 14927800, "profile_image_url_https": "https://si0.twimg.com/profile_images/1751674923/new_york_beard_normal.jpg", "profile_use_background_image": true, "listed_count": 150, "profile_text_color": "333333", "protected": false, "lang": "en", "followers_count": 8760, "time_zone": "Pacific Time (US & Canada)", "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme6/bg.gif", "verified": false, "profile_background_color": "709397", "notifications": false, "description": "Platform at Twitter", "geo_enabled": true, "statuses_count": 5532, "default_profile_image": false, "friends_count": 166, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme6/bg.gif", "show_all_inline_media": true, "screen_name": "jasoncosta", "following": false }, "source": "<a href=\"http://jason-costa.blogspot.com\" rel=\"nofollow\">My Shiny App</a>", "in_reply_to_screen_name": null, "in_reply_to_status_id": null }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  User is duplicating status or rate limit is exceeded.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /statuses/retweet/{id}{mediaTypeExtension}
POST

#### statuses retweet {id}{mediaTypeExtension}

POST
/statuses/retweet/{id}{mediaTypeExtension}
Description
Retweets a tweet. Returns the original tweet with retweet details embedded.

#### Request

##### Uri Parameters

- id (integer )
  The numerical ID of the desired status.
- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "truncated": false, "retweeted": false, "id_str": "243149503589400576", "coordinates": null, "in_reply_to_screen_name": null, "in_reply_to_status_id_str": null, "geo": null, "in_reply_to_status_id": null, "contributors": null, "source": "<a href=\"http://jason-costa.blogspot.com\" rel=\"nofollow\">My Shiny App</a>", "in_reply_to_user_id_str": null, "created_at": "Wed Sep 05 00:52:13 +0000 2012", "favorited": false, "entities": { "user_mentions": [ { "indices": [ 3, 10 ], "id_str": "7588892", "screen_name": "kurrik", "name": "Arne Roomann-Kurrik", "id": 7588892 } ], "hashtags": [], "urls": [] }, "user": { "following": false, "geo_enabled": true, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme6/bg.gif", "description": "Platform at Twitter", "notifications": false, "friends_count": 166, "profile_link_color": "FF3300", "location": "", "id_str": "14927800", "default_profile_image": false, "profile_image_url_https": "https://si0.twimg.com/profile_images/1751674923/new_york_beard_normal.jpg", "favourites_count": 883, "profile_background_color": "709397", "url": "http://t.co/YCA3ZKY", "screen_name": "jasoncosta", "profile_background_tile": false, "contributors_enabled": false, "verified": false, "created_at": "Wed May 28 00:20:15 +0000 2008", "profile_sidebar_fill_color": "A0C5C7", "followers_count": 8761, "lang": "en", "listed_count": 150, "profile_sidebar_border_color": "86A4A6", "protected": false, "entities": { "description": { "urls": [] }, "url": { "urls": [ { "indices": [ 0, 19 ], "url": "http://t.co/YCA3ZKY", "display_url": "jason-costa.blogspot.com", "expanded_url": "http://www.jason-costa.blogspot.com/" } ] } }, "show_all_inline_media": true, "follow_request_sent": false, "statuses_count": 5533, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme6/bg.gif", "name": "Jason Costa", "default_profile": false, "profile_use_background_image": true, "profile_image_url": "http://a0.twimg.com/profile_images/1751674923/new_york_beard_normal.jpg", "id": 14927800, "is_translator": true, "time_zone": "Pacific Time (US & Canada)", "utc_offset": -28800, "profile_text_color": "333333" }, "place": null, "id": 243149503589400580, "retweeted_status": { "truncated": false, "retweeted": false, "id_str": "241259202004267009", "coordinates": null, "in_reply_to_screen_name": null, "in_reply_to_status_id_str": null, "geo": null, "in_reply_to_status_id": null, "contributors": null, "source": "web", "in_reply_to_user_id_str": null, "created_at": "Thu Aug 30 19:40:50 +0000 2012", "favorited": false, "entities": { "user_mentions": [], "hashtags": [], "urls": [] }, "user": { "following": true, "geo_enabled": true, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/342542280/background7.png", "description": "Developer Advocate at Twitter, practitioner of dark sandwich arts. ", "notifications": false, "friends_count": 500, "profile_link_color": "0084B4", "location": "Scan Francesco", "id_str": "7588892", "default_profile_image": false, "profile_image_url_https": "https://si0.twimg.com/profile_images/24229162/arne001_normal.jpg", "favourites_count": 624, "profile_background_color": "8FC1FF", "url": "http://t.co/bGmVjSox", "screen_name": "kurrik", "profile_background_tile": true, "contributors_enabled": false, "verified": false, "created_at": "Thu Jul 19 15:58:07 +0000 2007", "profile_sidebar_fill_color": "C7E0FF", "followers_count": 3514, "lang": "en", "listed_count": 165, "profile_sidebar_border_color": "6BAEFF", "protected": false, "entities": { "description": { "urls": [] }, "url": { "urls": [ { "indices": [ 0, 20 ], "url": "http://t.co/bGmVjSox", "display_url": "start.roomanna.com", "expanded_url": "http://start.roomanna.com/" } ] } }, "show_all_inline_media": false, "follow_request_sent": false, "statuses_count": 2963, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/342542280/background7.png", "name": "Arne Roomann-Kurrik", "default_profile": false, "profile_use_background_image": true, "profile_image_url": "http://a0.twimg.com/profile_images/24229162/arne001_normal.jpg", "id": 7588892, "is_translator": false, "time_zone": "Pacific Time (US & Canada)", "utc_offset": -28800, "profile_text_color": "000000" }, "place": null, "id": 241259202004267000, "retweet_count": 1, "in_reply_to_user_id": null, "text": "tcptrace and imagemagick - two command line tools TOTALLY worth learning" }, "retweet_count": 1, "in_reply_to_user_id": null, "text": "RT @kurrik: tcptrace and imagemagick - two command line tools TOTALLY worth learning" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /statuses/update_with_media{mediaTypeExtension}
POST

#### statuses update_with_media{mediaTypeExtension}

POST
/statuses/update_with_media{mediaTypeExtension}
Description
Updates the authenticating user's current status and attaches media for upload. In other words, it creates a Tweet with a picture attached. Unlike POST statuses/update, this method expects raw multipart data. Your POST request's Content-Type should be set to multipart/form-data with the media[] parameter The Tweet text will be rewritten to include the media URL(s), which will reduce the number of characters allowed in the Tweet text. If the URL(s) cannot be appended without text truncation, the tweet will be rejected and this method will return an HTTP 403 error.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "contributors": null, "coordinates": null, "created_at": "Fri Sep 07 22:46:18 +0000 2012", "entities": { "hashtags": [], "media": [ { "display_url": "pic.twitter.com/lX5LVZO", "expanded_url": "http://twitter.com/fakekurrik/status/244204973972410368/photo/1", "id": 244204973989187600, "id_str": "244204973989187584", "indices": [ 44, 63 ], "media_url": "http://pbs.twimg.com/media/A2OXIUcCUAAXj9k.png", "media_url_https": "https://pbs.twimg.com/media/A2OXIUcCUAAXj9k.png", "sizes": { "large": { "h": 175, "resize": "fit", "w": 333 }, "medium": { "h": 175, "resize": "fit", "w": 333 }, "small": { "h": 175, "resize": "fit", "w": 333 }, "thumb": { "h": 150, "resize": "crop", "w": 150 } }, "type": "photo", "url": "http://t.co/lX5LVZO" } ], "urls": [], "user_mentions": [] }, "favorited": false, "geo": null, "id": 244204973972410370, "id_str": "244204973972410368", "in_reply_to_screen_name": null, "in_reply_to_status_id": null, "in_reply_to_status_id_str": null, "in_reply_to_user_id": null, "in_reply_to_user_id_str": null, "place": null, "possibly_sensitive": false, "retweet_count": 0, "retweeted": false, "source": "<a href=\"http://www.google.com\" rel=\"nofollow\">Fakekurrik's Test Application</a>", "text": "Hello 2012-09-07 15:48:27.889593 -0700 PDT! http://t.co/lX5LVZO", "truncated": false, "user": { "contributors_enabled": false, "created_at": "Fri Sep 09 16:13:20 +0000 2011", "default_profile": false, "default_profile_image": false, "description": "I am just a testing account, following me probably won't gain you very much", "entities": { "description": { "urls": [] }, "url": { "urls": [ { "display_url": null, "expanded_url": null, "indices": [ 0, 24 ], "url": "http://blog.roomanna.com" } ] } }, "favourites_count": 1, "follow_request_sent": false, "followers_count": 2, "following": false, "friends_count": 5, "geo_enabled": true, "id": 370773112, "id_str": "370773112", "is_translator": false, "lang": "en", "listed_count": 0, "location": "Trapped in factory", "name": "fakekurrik", "notifications": false, "profile_background_color": "C0DEED", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/616512781/iarz5lvj7lg7zpg3zv8j.jpeg", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/616512781/iarz5lvj7lg7zpg3zv8j.jpeg", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/2440719659/x47xdzkguqxr1w1gg5un_normal.png", "profile_image_url_https": "https://si0.twimg.com/profile_images/2440719659/x47xdzkguqxr1w1gg5un_normal.png", "profile_link_color": "0084B4", "profile_sidebar_border_color": "C0DEED", "profile_sidebar_fill_color": "FFFFFF", "profile_text_color": "333333", "profile_use_background_image": true, "protected": true, "screen_name": "fakekurrik", "show_all_inline_media": false, "statuses_count": 546, "time_zone": "Pacific Time (US & Canada)", "url": "http://blog.roomanna.com", "utc_offset": -28800, "verified": false } }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The URL(s) cannot be appended without text truncation.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /statuses/oembed{mediaTypeExtension}
GET

#### statuses oembed{mediaTypeExtension}

GET
/statuses/oembed{mediaTypeExtension}
Description
Returns information allowing the creation of an embedded representation of a Tweet on third party sites. See the oEmbed specification for information about the response format. While this endpoint allows a bit of customization for the final appearance of the embedded Tweet, be aware that the appearance of the rendered Tweet may change over time to be consistent with Twitter's Display Requirements. Do not rely on any class or id parameters to stay constant in the returned markup.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- id (integer )
  The Tweet/status ID to return embed code for.
- url (string )
  The URL of the Tweet/status to be embedded.
- maxwidth (integer )
  The maximum width in pixels that the embed should be rendered at.
- hide_media (string )
  Specifies whether the embedded Tweet should automatically expand images which were uploaded via POST statuses/update_with_media. When set to either true, t or 1 images will not be expanded.
- hide_thread (string )
  Specifies whether the embedded Tweet should automatically show the original message in the case that the embedded Tweet is a reply. When set to either true, t or 1 the original Tweet will not be shown.
- omit_script (string )
  Specifies whether the embedded Tweet HTML should include a <script> element pointing to widgets.js. In cases where a page already includes widgets.js, setting this value to true will prevent a redundant script element from being included. When set to either true, t or 1 the <script> element will not be included in the embed HTML, meaning that pages must include a reference to widgets.js manually.
- align (string )
  Specifies whether the embedded Tweet should be left aligned, right aligned, or centered in the page. Valid values are left, right, center, and none. Defaults to none, meaning no alignment styles are specified for the Tweet.
- related (string )
  A value for the TWT related parameter, as described in Web Intents. This value will be forwarded to all Web Intents calls.
- lang (string )
  Language code for the rendered embed. This will affect the text and localization of the rendered HTML.

- #### Response

- ##### Http Status code
  200

  Example is not provided by twitter docs.

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /statuses/retweeters/ids{mediaTypeExtension}
GET

#### statuses retweeters ids{mediaTypeExtension}

GET
/statuses/retweeters/ids{mediaTypeExtension}
Description
Returns a collection of up to 100 user IDs belonging to users who have retweeted the tweet specified by the id parameter.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- id (integer )
  The numerical ID of the desired status.
- cursor (integer )
  Causes the list of IDs to be broken into pages of no more than 100 IDs at a time. The number of IDs returned is not guaranteed to be 100 as suspended users are filtered out after connections are queried. If no cursor is provided, a value of -1 will be assumed, which is the first "page." The response from the API will include a previous_cursor and next_cursor to allow paging back and forth. See Using cursors to navigate collections for more information. While this method supports the cursor parameter, the entire result set can be returned in a single cursored collection. Using the count parameter with this method will not provide segmented cursors for use with this parameter.
- stringify_ids (string )
  Many programming environments will not consume our ids due to their size. Provide this option to have ids returned as strings instead. Read more about Twitter IDs, JSON and Snowflake.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "ids": [ "1382021622", "931150754", "1364953914", "92313481", "1398853771", "268642828", "1393765387", "417614795", "1401282895", "1319566290", "1398546265", "1332481988", "295679474", "967380524", "1278983791", "711759314", "1396957736", "1400099804", "1400006540", "307434897", "531100534", "553765661", "1398911250", "342624342", "629452817", "117815404", "137706363", "200935461", "387409391", "1361168810", "1368343309", "613471026", "439924515", "36049728", "1274405064", "1389815384", "1392424261", "577940232", "876175585", "510085789", "410346647", "1393727204", "1394189851", "1387201657", "1393950540", "900169760", "69572684", "517788963", "386168676", "1378242152", "18442587", "848640758", "1366022899", "25457359", "257764557", "795253765", "1170975386", "1229598968", "204528531", "954414061", "533154335", "580732530", "350798999", "427506664", "527674954", "1389957769", "496054455", "1338136910", "1390051482", "1252565820", "815941296", "1357349460", "1214535374", "1192879201", "1353712213", "229798008", "1382909124", "1026779562", "917199121", "1388715336", "1388417048", "106315621", "109159559", "523186040", "1256627971", "1137979866", "424946721", "1387875991" ], "previous_cursor_str": "0", "next_cursor": 0, "next_cursor_str": "0" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "previous_cursor": { "type": "integer" }, "ids": { "0": { "type": "integer" } }, "type": "array", "previous_cursor_str": { "type": "string" }, "next_cursor": { "type": "integer" }, "next_cursor_str": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /statuses/filter{mediaTypeExtension}
POST

#### statuses filter{mediaTypeExtension}

POST
/statuses/filter{mediaTypeExtension}
Description
Returns public statuses that match one or more filter predicates. Multiple parameters may be specified which allows most clients to use a single connection to the Streaming API. Both GET and POST requests are supported, but GET requests with too many parameters may cause the request to be rejected for excessive URL length. Use a POST request to avoid long URLs. The track, follow, and locations fields should be considered to be combined with an OR operator. track=foo&follow=1234 returns Tweets matching "foo" OR created by user 1234. The default access level allows up to 400 track keywords, 5,000 follow userids and 25 0.1-360 degree location boxes. If you need elevated access to the Streaming API, you should explore our partner providers of Twitter data here. Note: At least one predicate parameter (follow, locations, or track) must be specified.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Example is not provided by twitter docs.

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /statuses/sample{mediaTypeExtension}
GET

#### statuses sample{mediaTypeExtension}

GET
/statuses/sample{mediaTypeExtension}
Description
Returns a small random sample of all public statuses. The Tweets returned by the default access level are the same, so if two different clients connect to this endpoint, they will see the same Tweets.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- delimited (string )
  Specifies whether messages should be length-delimited. See the delimited parameter documentation for more information.
- stall_warnings (string )
  Specifies whether stall warnings should be delivered. See the stall_warnings parameter documentation for more information.

- #### Response

- ##### Http Status code
  200

  Example is not provided by twitter docs.

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /statuses/firehose{mediaTypeExtension}
GET

#### statuses firehose{mediaTypeExtension}

GET
/statuses/firehose{mediaTypeExtension}
Description
This endpoint requires special permission to access. Returns all public statuses. Few applications require this level of access. Creative use of a combination of other resources and various access levels can satisfy nearly every application use case.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- count (integer )
  The number of messages to backfill. See the count parameter documentation for more information.
- delimited (string )
  Specifies whether messages should be length-delimited. See the delimited parameter documentation for more information.
- stall_warnings (string )
  Specifies whether stall warnings should be delivered. See the stall_warnings parameter documentation for more information.

- #### Response

- ##### Http Status code
  200

  Example is not provided by twitter docs.

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /search/tweets{mediaTypeExtension}
GET

#### search tweets{mediaTypeExtension}

GET
/search/tweets{mediaTypeExtension}
Description
Returns a collection of relevant Tweets matching a specified query.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- q (string )
  A UTF-8, URL-encoded search query of 1,000 characters maximum, including operators. Queries may additionally be limited by complexity.
- geocode (string )
  Returns tweets by users located within a given radius of the given latitude/longitude. The location is preferentially taking from the Geotagging API, but will fall back to their Twitter profile. The parameter value is specified by "latitude,longitude,radius", where radius units must be specified as either "mi" (miles) or "km" (kilometers). Note that you cannot use the near operator via the API to geocode arbitrary locations; however you can use this geocode parameter to search near geocodes directly. A maximum of 1,000 distinct "sub-regions" will be considered when using the radius modifier.
- lang (string )
  Restricts tweets to the given language, given by an ISO 639-1 code. Language detection is best-effort.
- locale (string )
  Specify the language of the query you are sending (only ja is currently effective). This is intended for language-specific consumers and the default should work in the majority of cases.

  ###### Example

      ja

- result_type (string )
  Specifies what type of search results you would prefer to receive. The current default is "mixed." Valid values include * mixed: Include both popular and real time results in the response. * recent: return only the most recent results in the response * popular: return only the most popular results in the response.
- count (integer )
  The number of tweets to return per page, up to a maximum of 100.
- until (string )
  Returns tweets generated before the given date. Date should be formatted as YYYY-MM-DD. Keep in mind that the search index may not go back as far as the date you specify here.
- since_id (integer )
  Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occured since the since_id, the since_id will be forced to the oldest ID available.
- max_id (integer )
  Returns results with an ID less than (that is, older than) or equal to the specified ID.
- callback (string )
  If supplied, the response will use the JSONP format with a callback of the given name. The usefulness of this parameter is somewhat diminished by the requirement of authentication for requests to this endpoint.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "statuses": [ { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Mon Sep 24 03:35:21 +0000 2012", "id_str": "250075927172759552", "entities": { "urls": [], "hashtags": [ { "text": "freebandnames", "indices": [ 20, 34 ] } ], "user_mentions": [] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "Aggressive Ponytail #freebandnames", "metadata": { "iso_language_code": "en", "result_type": "recent" }, "retweet_count": 0, "in_reply_to_status_id_str": null, "id": 250075927172759550, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "place": null, "user": { "profile_sidebar_fill_color": "DDEEF6", "profile_sidebar_border_color": "C0DEED", "profile_background_tile": false, "name": "Sean Cummings", "profile_image_url": "http://a0.twimg.com/profile_images/2359746665/1v6zfgqo8g0d3mk7ii5s_normal.jpeg", "created_at": "Mon Apr 26 06:01:55 +0000 2010", "location": "LA, CA", "follow_request_sent": null, "profile_link_color": "0084B4", "is_translator": false, "id_str": "137238150", "entities": { "url": { "urls": [ { "expanded_url": null, "url": "", "indices": [ 0, 0 ] } ] }, "description": { "urls": [] } }, "default_profile": true, "contributors_enabled": false, "favourites_count": 0, "url": null, "profile_image_url_https": "https://si0.twimg.com/profile_images/2359746665/1v6zfgqo8g0d3mk7ii5s_normal.jpeg", "utc_offset": -28800, "id": 137238150, "profile_use_background_image": true, "listed_count": 2, "profile_text_color": "333333", "lang": "en", "followers_count": 70, "protected": false, "notifications": null, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "profile_background_color": "C0DEED", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Born 330 Live 310", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "statuses_count": 579, "friends_count": 110, "following": null, "show_all_inline_media": false, "screen_name": "sean_cummings" }, "in_reply_to_screen_name": null, "source": "<a href=\"http://itunes.apple.com/us/app/twitter/id409789998?mt=12\" rel=\"nofollow\">Twitter for Mac</a>", "in_reply_to_status_id": null }, { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Fri Sep 21 23:40:54 +0000 2012", "id_str": "249292149810667520", "entities": { "urls": [], "hashtags": [ { "text": "FreeBandNames", "indices": [ 20, 34 ] } ], "user_mentions": [] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "Thee Namaste Nerdz. #FreeBandNames", "metadata": { "iso_language_code": "pl", "result_type": "recent" }, "retweet_count": 0, "in_reply_to_status_id_str": null, "id": 249292149810667520, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "place": null, "user": { "profile_sidebar_fill_color": "DDFFCC", "profile_sidebar_border_color": "BDDCAD", "profile_background_tile": true, "name": "Chaz Martenstein", "profile_image_url": "http://a0.twimg.com/profile_images/447958234/Lichtenstein_normal.jpg", "created_at": "Tue Apr 07 19:05:07 +0000 2009", "location": "Durham, NC", "follow_request_sent": null, "profile_link_color": "0084B4", "is_translator": false, "id_str": "29516238", "entities": { "url": { "urls": [ { "expanded_url": null, "url": "http://bullcityrecords.com/wnng/", "indices": [ 0, 32 ] } ] }, "description": { "urls": [] } }, "default_profile": false, "contributors_enabled": false, "favourites_count": 8, "url": "http://bullcityrecords.com/wnng/", "profile_image_url_https": "https://si0.twimg.com/profile_images/447958234/Lichtenstein_normal.jpg", "utc_offset": -18000, "id": 29516238, "profile_use_background_image": true, "listed_count": 118, "profile_text_color": "333333", "lang": "en", "followers_count": 2052, "protected": false, "notifications": null, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/9423277/background_tile.bmp", "profile_background_color": "9AE4E8", "verified": false, "geo_enabled": false, "time_zone": "Eastern Time (US & Canada)", "description": "You will come to Durham, North Carolina. I will sell you some records then, here in Durham, North Carolina. Fun will happen.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/9423277/background_tile.bmp", "statuses_count": 7579, "friends_count": 348, "following": null, "show_all_inline_media": true, "screen_name": "bullcityrecords" }, "in_reply_to_screen_name": null, "source": "web", "in_reply_to_status_id": null }, { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Fri Sep 21 23:30:20 +0000 2012", "id_str": "249289491129438208", "entities": { "urls": [], "hashtags": [ { "text": "freebandnames", "indices": [ 29, 43 ] } ], "user_mentions": [] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "Mexican Heaven, Mexican Hell #freebandnames", "metadata": { "iso_language_code": "en", "result_type": "recent" }, "retweet_count": 0, "in_reply_to_status_id_str": null, "id": 249289491129438200, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "place": null, "user": { "profile_sidebar_fill_color": "99CC33", "profile_sidebar_border_color": "829D5E", "profile_background_tile": false, "name": "Thomas John Wakeman", "profile_image_url": "http://a0.twimg.com/profile_images/2219333930/Froggystyle_normal.png", "created_at": "Tue Sep 01 21:21:35 +0000 2009", "location": "Kingston New York", "follow_request_sent": null, "profile_link_color": "D02B55", "is_translator": false, "id_str": "70789458", "entities": { "url": { "urls": [ { "expanded_url": null, "url": "", "indices": [ 0, 0 ] } ] }, "description": { "urls": [] } }, "default_profile": false, "contributors_enabled": false, "favourites_count": 19, "url": null, "profile_image_url_https": "https://si0.twimg.com/profile_images/2219333930/Froggystyle_normal.png", "utc_offset": -18000, "id": 70789458, "profile_use_background_image": true, "listed_count": 1, "profile_text_color": "3E4415", "lang": "en", "followers_count": 63, "protected": false, "notifications": null, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme5/bg.gif", "profile_background_color": "352726", "verified": false, "geo_enabled": false, "time_zone": "Eastern Time (US & Canada)", "description": "Science Fiction Writer, sort of. Likes Superheroes, Mole People, Alt. Timelines.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme5/bg.gif", "statuses_count": 1048, "friends_count": 63, "following": null, "show_all_inline_media": false, "screen_name": "MonkiesFist" }, "in_reply_to_screen_name": null, "source": "web", "in_reply_to_status_id": null }, { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Fri Sep 21 22:51:18 +0000 2012", "id_str": "249279667666817024", "entities": { "urls": [], "hashtags": [ { "text": "freebandnames", "indices": [ 20, 34 ] } ], "user_mentions": [] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "The Foolish Mortals #freebandnames", "metadata": { "iso_language_code": "en", "result_type": "recent" }, "retweet_count": 0, "in_reply_to_status_id_str": null, "id": 249279667666817020, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "place": null, "user": { "profile_sidebar_fill_color": "BFAC83", "profile_sidebar_border_color": "615A44", "profile_background_tile": true, "name": "Marty Elmer", "profile_image_url": "http://a0.twimg.com/profile_images/1629790393/shrinker_2000_trans_normal.png", "created_at": "Mon May 04 00:05:00 +0000 2009", "location": "Wisconsin, USA", "follow_request_sent": null, "profile_link_color": "3B2A26", "is_translator": false, "id_str": "37539828", "entities": { "url": { "urls": [ { "expanded_url": null, "url": "http://www.omnitarian.me", "indices": [ 0, 24 ] } ] }, "description": { "urls": [] } }, "default_profile": false, "contributors_enabled": false, "favourites_count": 647, "url": "http://www.omnitarian.me", "profile_image_url_https": "https://si0.twimg.com/profile_images/1629790393/shrinker_2000_trans_normal.png", "utc_offset": -21600, "id": 37539828, "profile_use_background_image": true, "listed_count": 52, "profile_text_color": "000000", "lang": "en", "followers_count": 608, "protected": false, "notifications": null, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/106455659/rect6056-9.png", "profile_background_color": "EEE3C4", "verified": false, "geo_enabled": false, "time_zone": "Central Time (US & Canada)", "description": "Cartoonist, Illustrator, and T-Shirt connoisseur", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/106455659/rect6056-9.png", "statuses_count": 3575, "friends_count": 249, "following": null, "show_all_inline_media": true, "screen_name": "Omnitarian" }, "in_reply_to_screen_name": null, "source": "<a href=\"http://twitter.com/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>", "in_reply_to_status_id": null } ], "search_metadata": { "max_id": 250126199840518140, "since_id": 24012619984051000, "refresh_url": "?since_id=250126199840518145&q=%23freebandnames&result_type=mixed&include_entities=1", "next_results": "?max_id=249279667666817023&q=%23freebandnames&count=4&include_entities=1&result_type=mixed", "count": 4, "completed_in": 0.035, "since_id_str": "24012619984051000", "query": "%23freebandnames", "max_id_str": "250126199840518145" } }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /direct_messages{mediaTypeExtension}
GET

#### direct_messages{mediaTypeExtension}

GET
/direct_messages{mediaTypeExtension}
Description
Returns the 20 most recent direct messages sent to the authenticating user. Includes detailed information about the sender and recipient user. You can request up to 200 direct messages per call, up to a maximum of 800 incoming DMs. Important: This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information. (https://dev.twitter.com/docs/application-permission-model)

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- since_id (integer )
  Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occured since the since_id, the since_id will be forced to the oldest ID available.
- max_id (integer )
  Returns results with an ID less than (that is, older than) or equal to the specified ID.
- count (integer )
  Specifies the number of direct messages to try and retrieve, up to a maximum of 200. The value of count is best thought of as a limit to the number of Tweets to return because suspended or deleted content is removed after the count has been applied.
- skip_status (string )
  When set to either true, t or 1 statuses will not be included in the returned user objects.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "created_at": "Mon Aug 27 17:21:03 +0000 2012", "entities": { "hashtags": [], "urls": [], "user_mentions": [] }, "id": 240136858829479940, "id_str": "240136858829479936", "recipient": { "contributors_enabled": false, "created_at": "Thu Aug 23 19:45:07 +0000 2012", "default_profile": false, "default_profile_image": false, "description": "Keep calm and test", "favourites_count": 0, "follow_request_sent": false, "followers_count": 0, "following": false, "friends_count": 10, "geo_enabled": true, "id": 776627022, "id_str": "776627022", "is_translator": false, "lang": "en", "listed_count": 0, "location": "San Francisco, CA", "name": "Mick Jagger", "notifications": false, "profile_background_color": "000000", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/2550226257/y0ef5abcx5yrba8du0sk_normal.jpeg", "profile_image_url_https": "https://si0.twimg.com/profile_images/2550226257/y0ef5abcx5yrba8du0sk_normal.jpeg", "profile_link_color": "000000", "profile_sidebar_border_color": "000000", "profile_sidebar_fill_color": "000000", "profile_text_color": "000000", "profile_use_background_image": false, "protected": false, "screen_name": "s0c1alm3dia", "show_all_inline_media": false, "statuses_count": 0, "time_zone": "Pacific Time (US & Canada)", "url": "http://cnn.com", "utc_offset": -28800, "verified": false }, "recipient_id": 776627022, "recipient_screen_name": "s0c1alm3dia", "sender": { "contributors_enabled": true, "created_at": "Sat May 09 17:58:22 +0000 2009", "default_profile": false, "default_profile_image": false, "description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ", "favourites_count": 584, "follow_request_sent": false, "followers_count": 10621, "following": false, "friends_count": 1181, "geo_enabled": true, "id": 38895958, "id_str": "38895958", "is_translator": false, "lang": "en", "listed_count": 190, "location": "San Francisco", "name": "Sean Cook", "notifications": false, "profile_background_color": "1A1B1F", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_link_color": "2FC2EF", "profile_sidebar_border_color": "181A1E", "profile_sidebar_fill_color": "252429", "profile_text_color": "666666", "profile_use_background_image": true, "protected": false, "screen_name": "theSeanCook", "show_all_inline_media": true, "statuses_count": 2608, "time_zone": "Pacific Time (US & Canada)", "url": null, "utc_offset": -28800, "verified": false }, "sender_id": 38895958, "sender_screen_name": "theSeanCook", "text": "booyakasha" } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /direct_messages{mediaTypeExtension}/sent{mediaTypeExtension}
GET

#### direct_messages{mediaTypeExtension} sent{mediaTypeExtension}

GET
/direct_messages{mediaTypeExtension}/sent{mediaTypeExtension}
Description
Returns the 20 most recent direct messages sent by the authenticating user. Includes detailed information about the sender and recipient user. You can request up to 200 direct messages per call, up to a maximum of 800 outgoing DMs. Important: This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- since_id (integer )
  Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occured since the since_id, the since_id will be forced to the oldest ID available.
- max_id (integer )
  Returns results with an ID less than (that is, older than) or equal to the specified ID.
- count (integer )
  Specifies the number of direct messages to try and retrieve, up to a maximum of 200. The value of count is best thought of as a limit to the number of Tweets to return because suspended or deleted content is removed after the count has been applied.
- page (integer )
  Specifies the page of results to retrieve.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "created_at": "Tue Aug 28 00:40:56 +0000 2012", "entities": { "hashtags": [], "urls": [], "user_mentions": [] }, "id": 240247560269340670, "id_str": "240247560269340673", "recipient": { "contributors_enabled": true, "created_at": "Sat May 09 17:58:22 +0000 2009", "default_profile": false, "default_profile_image": false, "description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ", "favourites_count": 584, "follow_request_sent": false, "followers_count": 10622, "following": true, "friends_count": 1181, "geo_enabled": true, "id": 38895958, "id_str": "38895958", "is_translator": false, "lang": "en", "listed_count": 190, "location": "San Francisco", "name": "Sean Cook", "notifications": false, "profile_background_color": "1A1B1F", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_link_color": "2FC2EF", "profile_sidebar_border_color": "181A1E", "profile_sidebar_fill_color": "252429", "profile_text_color": "666666", "profile_use_background_image": true, "protected": false, "screen_name": "theSeanCook", "show_all_inline_media": true, "statuses_count": 2608, "time_zone": "Pacific Time (US & Canada)", "url": null, "utc_offset": -28800, "verified": false }, "recipient_id": 38895958, "recipient_screen_name": "theSeanCook", "sender": { "contributors_enabled": false, "created_at": "Thu Aug 23 19:45:07 +0000 2012", "default_profile": false, "default_profile_image": false, "description": "Keep calm and test", "favourites_count": 0, "follow_request_sent": false, "followers_count": 0, "following": false, "friends_count": 11, "geo_enabled": true, "id": 776627022, "id_str": "776627022", "is_translator": false, "lang": "en", "listed_count": 0, "location": "San Francisco, CA", "name": "Mick Jagger", "notifications": false, "profile_background_color": "000000", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", "profile_image_url_https": "https://si0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", "profile_link_color": "000000", "profile_sidebar_border_color": "000000", "profile_sidebar_fill_color": "000000", "profile_text_color": "000000", "profile_use_background_image": false, "protected": false, "screen_name": "s0c1alm3dia", "show_all_inline_media": false, "statuses_count": 0, "time_zone": "Pacific Time (US & Canada)", "url": "http://cnn.com", "utc_offset": -28800, "verified": false }, "sender_id": 776627022, "sender_screen_name": "s0c1alm3dia", "text": "Meet me behind the cafeteria after school." } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /direct_messages{mediaTypeExtension}/show{mediaTypeExtension}
GET

#### direct_messages{mediaTypeExtension} show{mediaTypeExtension}

GET
/direct_messages{mediaTypeExtension}/show{mediaTypeExtension}
Description
Returns a single direct message, specified by an id parameter. Like the /1.1/direct_messages.format request, this method will include the user objects of the sender and recipient. Important: This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- id (integer )
  The ID of the direct message.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "created_at": "Mon Aug 27 17:21:03 +0000 2012", "entities": { "hashtags": [], "urls": [], "user_mentions": [] }, "id": 240136858829479940, "id_str": "240136858829479936", "recipient": { "contributors_enabled": false, "created_at": "Thu Aug 23 19:45:07 +0000 2012", "default_profile": false, "default_profile_image": false, "description": "Keep calm and test", "favourites_count": 0, "follow_request_sent": false, "followers_count": 0, "following": false, "friends_count": 10, "geo_enabled": true, "id": 776627022, "id_str": "776627022", "is_translator": false, "lang": "en", "listed_count": 0, "location": "San Francisco, CA", "name": "Mick Jagger", "notifications": false, "profile_background_color": "000000", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/2550226257/y0ef5abcx5yrba8du0sk_normal.jpeg", "profile_image_url_https": "https://si0.twimg.com/profile_images/2550226257/y0ef5abcx5yrba8du0sk_normal.jpeg", "profile_link_color": "000000", "profile_sidebar_border_color": "000000", "profile_sidebar_fill_color": "000000", "profile_text_color": "000000", "profile_use_background_image": false, "protected": false, "screen_name": "s0c1alm3dia", "show_all_inline_media": false, "statuses_count": 0, "time_zone": "Pacific Time (US & Canada)", "url": "http://cnn.com", "utc_offset": -28800, "verified": false }, "recipient_id": 776627022, "recipient_screen_name": "s0c1alm3dia", "sender": { "contributors_enabled": true, "created_at": "Sat May 09 17:58:22 +0000 2009", "default_profile": false, "default_profile_image": false, "description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ", "favourites_count": 584, "follow_request_sent": false, "followers_count": 10621, "following": false, "friends_count": 1181, "geo_enabled": true, "id": 38895958, "id_str": "38895958", "is_translator": false, "lang": "en", "listed_count": 190, "location": "San Francisco", "name": "Sean Cook", "notifications": false, "profile_background_color": "1A1B1F", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_link_color": "2FC2EF", "profile_sidebar_border_color": "181A1E", "profile_sidebar_fill_color": "252429", "profile_text_color": "666666", "profile_use_background_image": true, "protected": false, "screen_name": "theSeanCook", "show_all_inline_media": true, "statuses_count": 2608, "time_zone": "Pacific Time (US & Canada)", "url": null, "utc_offset": -28800, "verified": false }, "sender_id": 38895958, "sender_screen_name": "theSeanCook", "text": "booyakasha" } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /direct_messages{mediaTypeExtension}/destroy{mediaTypeExtension}
POST

#### direct_messages{mediaTypeExtension} destroy{mediaTypeExtension}

POST
/direct_messages{mediaTypeExtension}/destroy{mediaTypeExtension}
Description
Destroys the direct message specified in the required ID parameter. The authenticating user must be the recipient of the specified direct message. Important: This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "created_at": "Tue Aug 28 00:57:15 +0000 2012", "entities": { "hashtags": [], "urls": [], "user_mentions": [] }, "id": 240251665733795840, "id_str": "240251665733795841", "recipient": { "contributors_enabled": true, "created_at": "Sat May 09 17:58:22 +0000 2009", "default_profile": false, "default_profile_image": false, "description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ", "favourites_count": 584, "follow_request_sent": false, "followers_count": 10622, "following": true, "friends_count": 1181, "geo_enabled": true, "id": 38895958, "id_str": "38895958", "is_translator": false, "lang": "en", "listed_count": 190, "location": "San Francisco", "name": "Sean Cook", "notifications": false, "profile_background_color": "1A1B1F", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_link_color": "2FC2EF", "profile_sidebar_border_color": "181A1E", "profile_sidebar_fill_color": "252429", "profile_text_color": "666666", "profile_use_background_image": true, "protected": false, "screen_name": "theSeanCook", "show_all_inline_media": true, "statuses_count": 2608, "time_zone": "Pacific Time (US & Canada)", "url": null, "utc_offset": -28800, "verified": false }, "recipient_id": 38895958, "recipient_screen_name": "theSeanCook", "sender": { "contributors_enabled": false, "created_at": "Thu Aug 23 19:45:07 +0000 2012", "default_profile": false, "default_profile_image": false, "description": "Keep calm and test", "favourites_count": 0, "follow_request_sent": false, "followers_count": 0, "following": false, "friends_count": 11, "geo_enabled": true, "id": 776627022, "id_str": "776627022", "is_translator": false, "lang": "en", "listed_count": 0, "location": "San Francisco, CA", "name": "Mick Jagger", "notifications": false, "profile_background_color": "000000", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", "profile_image_url_https": "https://si0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", "profile_link_color": "000000", "profile_sidebar_border_color": "000000", "profile_sidebar_fill_color": "000000", "profile_text_color": "000000", "profile_use_background_image": false, "protected": false, "screen_name": "s0c1alm3dia", "show_all_inline_media": false, "statuses_count": 0, "time_zone": "Pacific Time (US & Canada)", "url": "http://cnn.com", "utc_offset": -28800, "verified": false }, "sender_id": 776627022, "sender_screen_name": "s0c1alm3dia", "text": "hello, tworld." }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /direct_messages{mediaTypeExtension}/new{mediaTypeExtension}
POST

#### direct_messages{mediaTypeExtension} new{mediaTypeExtension}

POST
/direct_messages{mediaTypeExtension}/new{mediaTypeExtension}
Description
Sends a new direct message to the specified user from the authenticating user. Requires both the user and text parameters and must be a POST. Returns the sent message in the requested format if successful.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "created_at": "Tue Aug 28 00:59:49 +0000 2012", "entities": { "hashtags": [], "urls": [], "user_mentions": [] }, "id": 240252311455277060, "id_str": "240252311455277056", "recipient": { "contributors_enabled": true, "created_at": "Sat May 09 17:58:22 +0000 2009", "default_profile": false, "default_profile_image": false, "description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ", "favourites_count": 584, "follow_request_sent": false, "followers_count": 10622, "following": true, "friends_count": 1181, "geo_enabled": true, "id": 38895958, "id_str": "38895958", "is_translator": false, "lang": "en", "listed_count": 190, "location": "San Francisco", "name": "Sean Cook", "notifications": false, "profile_background_color": "1A1B1F", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_link_color": "2FC2EF", "profile_sidebar_border_color": "181A1E", "profile_sidebar_fill_color": "252429", "profile_text_color": "666666", "profile_use_background_image": true, "protected": false, "screen_name": "theSeanCook", "show_all_inline_media": true, "statuses_count": 2608, "time_zone": "Pacific Time (US & Canada)", "url": null, "utc_offset": -28800, "verified": false }, "recipient_id": 38895958, "recipient_screen_name": "theSeanCook", "sender": { "contributors_enabled": false, "created_at": "Thu Aug 23 19:45:07 +0000 2012", "default_profile": false, "default_profile_image": false, "description": "Keep calm and test", "favourites_count": 0, "follow_request_sent": false, "followers_count": 0, "following": false, "friends_count": 11, "geo_enabled": true, "id": 776627022, "id_str": "776627022", "is_translator": false, "lang": "en", "listed_count": 0, "location": "San Francisco, CA", "name": "Mick Jagger", "notifications": false, "profile_background_color": "000000", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", "profile_image_url_https": "https://si0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", "profile_link_color": "000000", "profile_sidebar_border_color": "000000", "profile_sidebar_fill_color": "000000", "profile_text_color": "000000", "profile_use_background_image": false, "protected": false, "screen_name": "s0c1alm3dia", "show_all_inline_media": false, "statuses_count": 0, "time_zone": "Pacific Time (US & Canada)", "url": "http://cnn.com", "utc_offset": -28800, "verified": false }, "sender_id": 776627022, "sender_screen_name": "s0c1alm3dia", "text": "hello, tworld. welcome to 1.1." }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /friendships{mediaTypeExtension}

#### friendships{mediaTypeExtension}

URl: /friendships{mediaTypeExtension}/no_retweets/ids{mediaTypeExtension}
GET

#### friendships{mediaTypeExtension} no_retweets ids{mediaTypeExtension}

GET
/friendships{mediaTypeExtension}/no_retweets/ids{mediaTypeExtension}
Description
Returns a collection of user_ids that the currently authenticated user does not want to receive retweets from. Use POST friendships/update to set the "no retweets" status for a given user account on behalf of the current user.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- stringify_ids (string )
  Many programming environments will not consume our ids due to their size. Provide this option to have ids returned as strings instead. Read more about Twitter IDs, JSON and Snowflake. This parameter is especially important to use in Javascript environments.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  ["777925","732321"]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "type": "string" } }, "type": "array" } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /friendships{mediaTypeExtension}/lookup{mediaTypeExtension}
GET

#### friendships{mediaTypeExtension} lookup{mediaTypeExtension}

GET
/friendships{mediaTypeExtension}/lookup{mediaTypeExtension}
Description
Returns the relationships of the authenticating user to the comma-separated list of up to 100 screen_names or user_ids provided. Values for connections can be: following, following_requested, followed_by, none.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- screen_name (string )
  A comma separated list of screen names, up to 100 are allowed in a single request.

  ###### Example

      twitterapi,twitter

- user_id (string )
  A comma separated list of user IDs, up to 100 are allowed in a single request.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "name": "Taylor Singletary", "id_str": "819797", "id": 819797, "connections": [ "none" ], "screen_name": "episod" }, { "name": "Twitter API", "id_str": "6253282", "id": 6253282, "connections": [ "following", "followed_by" ], "screen_name": "twitterapi" } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "name": { "type": "string" }, "id_str": { "type": "string" }, "id": { "type": "integer" }, "connections": { "0": { "type": "string" } }, "type": "array", "screen_name": { "type": "string" } }, "type": "object" } }, "type": "array" } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /friendships{mediaTypeExtension}/incoming{mediaTypeExtension}
GET

#### friendships{mediaTypeExtension} incoming{mediaTypeExtension}

GET
/friendships{mediaTypeExtension}/incoming{mediaTypeExtension}
Description
Returns a collection of numeric IDs for every user who has a pending request to follow the authenticating user.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- cursor (integer )
  Causes the list of connections to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to be 5000 as suspended users are filtered out after connections are queried. If no cursor is provided, a value of -1 will be assumed, which is the first "page." The response from the API will include a previous_cursor and next_cursor to allow paging back and forth. See Using cursors to navigate collections for more information.
- stringify_ids (string )
  Many programming environments will not consume our Tweet ids due to their size. Provide this option to have ids returned as strings instead. More about Twitter IDs, JSON and Snowflake.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "ids": [ 657693, 183709371, 7588892, 38895958, 22891211, 9019482, 14488353, 11750202, 12249, 22915745, 1249881, 14927800, 1523501, 22548447, 15062340, 133031077, 17874544, 777925, 4265731, 27674040, 26123649, 9576402, 821958, 7852612, 819797, 1401881, 8285392, 9160152, 795649, 3191321, 783214 ], "previous_cursor_str": "0", "next_cursor": 0, "next_cursor_str": "0" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "previous_cursor": { "type": "integer" }, "ids": { "0": { "type": "integer" } }, "type": "array", "previous_cursor_str": { "type": "string" }, "next_cursor": { "type": "integer" }, "next_cursor_str": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /friendships{mediaTypeExtension}/outgoing{mediaTypeExtension}
GET

#### friendships{mediaTypeExtension} outgoing{mediaTypeExtension}

GET
/friendships{mediaTypeExtension}/outgoing{mediaTypeExtension}
Description
Returns a collection of numeric IDs for every protected user for whom the authenticating user has a pending follow request.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- cursor (integer )
  Causes the list of connections to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to be 5000 as suspended users are filtered out after connections are queried. If no cursor is provided, a value of -1 will be assumed, which is the first "page." The response from the API will include a previous_cursor and next_cursor to allow paging back and forth. See Using cursors to navigate collections for more information.
- stringify_ids (string )
  Many programming environments will not consume our Tweet ids due to their size. Provide this option to have ids returned as strings instead. More about Twitter IDs, JSON and Snowflake.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "ids": [ 657693, 183709371, 7588892, 38895958, 22891211, 9019482, 14488353, 11750202, 12249, 22915745, 1249881, 14927800, 1523501, 22548447, 15062340, 133031077, 17874544, 777925, 4265731, 27674040, 26123649, 9576402, 821958, 7852612, 819797, 1401881, 8285392, 9160152, 795649, 3191321, 783214 ], "previous_cursor_str": "0", "next_cursor": 0, "next_cursor_str": "0" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "previous_cursor": { "type": "integer" }, "ids": { "0": { "type": "integer" } }, "type": "array", "previous_cursor_str": { "type": "string" }, "next_cursor": { "type": "integer" }, "next_cursor_str": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /friendships{mediaTypeExtension}/create{mediaTypeExtension}
POST

#### friendships{mediaTypeExtension} create{mediaTypeExtension}

POST
/friendships{mediaTypeExtension}/create{mediaTypeExtension}
Description
Allows the authenticating users to follow the user specified in the ID parameter. Returns the befriended user in the requested format when successful. Returns a string describing the failure condition when unsuccessful. If you are already friends with the user a HTTP 403 may be returned, though for performance reasons you may get a 200 OK message even if the friendship already exists. Actions taken in this method are asynchronous and changes will be eventually consistent.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "name": "Doug Williams", "profile_sidebar_border_color": "87BC44", "profile_sidebar_fill_color": "F2F8FC", "profile_background_tile": false, "created_at": "Sun Mar 18 06:42:26 +0000 2007", "profile_image_url": "http://a0.twimg.com/profile_images/1947332700/dougw_avatar_can2_normal.jpg", "location": "San Francisco, CA", "profile_link_color": "0000FF", "follow_request_sent": false, "is_translator": false, "id_str": "1401881", "entities": { "description": { "urls": [] } }, "default_profile": false, "url": null, "favourites_count": 2620, "contributors_enabled": true, "utc_offset": -28800, "id": 1401881, "profile_image_url_https": "https://si0.twimg.com/profile_images/1947332700/dougw_avatar_can2_normal.jpg", "listed_count": 890, "profile_use_background_image": true, "profile_text_color": "000000", "protected": false, "lang": "en", "followers_count": 306557, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "notifications": false, "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/2752608/twitter_bg_grass.jpg", "profile_background_color": "9AE4E8", "description": "Partnerships at @twitter", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/2752608/twitter_bg_grass.jpg", "friends_count": 1284, "statuses_count": 11873, "default_profile_image": false, "status": { "coordinates": null, "truncated": false, "created_at": "Sun Aug 26 21:58:35 +0000 2012", "favorited": false, "id_str": "239844310982459392", "entities": { "urls": [], "media": [ { "media_url_https": "https://p.twimg.com/A1QZIU3CAAAnCkS.jpg", "expanded_url": "http://twitter.com/dougw/status/239844310982459392/photo/1", "sizes": { "large": { "w": 816, "resize": "fit", "h": 612 }, "medium": { "w": 600, "resize": "fit", "h": 450 }, "small": { "w": 340, "resize": "fit", "h": 255 }, "thumb": { "w": 150, "resize": "crop", "h": 150 } }, "id_str": "239844310986653696", "url": "http://t.co/1uG4mhaB", "id": 239844310986653700, "type": "photo", "indices": [ 45, 65 ], "media_url": "http://p.twimg.com/A1QZIU3CAAAnCkS.jpg", "display_url": "pic.twitter.com/1uG4mhaB" } ], "hashtags": [], "user_mentions": [] }, "in_reply_to_user_id_str": null, "text": "Warm day by the Bay. Watching boats sail by. http://t.co/1uG4mhaB", "contributors": null, "id": 239844310982459400, "retweet_count": 0, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "possibly_sensitive": false, "place": null, "possibly_sensitive_editable": true, "source": "<a href=\"http://www.apple.com\" rel=\"nofollow\">Camera on iOS</a>", "in_reply_to_screen_name": null, "in_reply_to_status_id": null }, "show_all_inline_media": true, "screen_name": "dougw", "following": true }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  If you are already friends with the user.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /friendships{mediaTypeExtension}/destroy{mediaTypeExtension}
POST

#### friendships{mediaTypeExtension} destroy{mediaTypeExtension}

POST
/friendships{mediaTypeExtension}/destroy{mediaTypeExtension}
Description
Allows the authenticating user to unfollow the user specified in the ID parameter. Returns the unfollowed user in the requested format when successful. Returns a string describing the failure condition when unsuccessful. Actions taken in this method are asynchronous and changes will be eventually consistent.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "name": "Doug Williams", "profile_sidebar_border_color": "87BC44", "profile_sidebar_fill_color": "F2F8FC", "profile_background_tile": false, "created_at": "Sun Mar 18 06:42:26 +0000 2007", "profile_image_url": "http://a0.twimg.com/profile_images/1947332700/dougw_avatar_can2_normal.jpg", "location": "San Francisco, CA", "profile_link_color": "0000FF", "follow_request_sent": false, "is_translator": false, "id_str": "1401881", "entities": { "description": { "urls": [] } }, "default_profile": false, "url": null, "favourites_count": 2620, "contributors_enabled": true, "utc_offset": -28800, "id": 1401881, "profile_image_url_https": "https://si0.twimg.com/profile_images/1947332700/dougw_avatar_can2_normal.jpg", "listed_count": 890, "profile_use_background_image": true, "profile_text_color": "000000", "protected": false, "lang": "en", "followers_count": 306556, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "notifications": false, "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/2752608/twitter_bg_grass.jpg", "profile_background_color": "9AE4E8", "description": "Partnerships at @twitter", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/2752608/twitter_bg_grass.jpg", "friends_count": 1284, "statuses_count": 11873, "default_profile_image": false, "status": { "coordinates": null, "truncated": false, "created_at": "Sun Aug 26 21:58:35 +0000 2012", "favorited": false, "id_str": "239844310982459392", "entities": { "urls": [], "media": [ { "media_url_https": "https://p.twimg.com/A1QZIU3CAAAnCkS.jpg", "expanded_url": "http://twitter.com/dougw/status/239844310982459392/photo/1", "sizes": { "large": { "w": 816, "resize": "fit", "h": 612 }, "medium": { "w": 600, "resize": "fit", "h": 450 }, "small": { "w": 340, "resize": "fit", "h": 255 }, "thumb": { "w": 150, "resize": "crop", "h": 150 } }, "id_str": "239844310986653696", "url": "http://t.co/1uG4mhaB", "id": 239844310986653700, "type": "photo", "indices": [ 45, 65 ], "media_url": "http://p.twimg.com/A1QZIU3CAAAnCkS.jpg", "display_url": "pic.twitter.com/1uG4mhaB" } ], "hashtags": [], "user_mentions": [] }, "in_reply_to_user_id_str": null, "text": "Warm day by the Bay. Watching boats sail by. http://t.co/1uG4mhaB", "contributors": null, "id": 239844310982459400, "retweet_count": 0, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "possibly_sensitive": false, "place": null, "possibly_sensitive_editable": true, "source": "<a href=\"http://www.apple.com\" rel=\"nofollow\">Camera on iOS</a>", "in_reply_to_screen_name": null, "in_reply_to_status_id": null }, "show_all_inline_media": true, "screen_name": "dougw", "following": false }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /friendships{mediaTypeExtension}/update{mediaTypeExtension}
POST

#### friendships{mediaTypeExtension} update{mediaTypeExtension}

POST
/friendships{mediaTypeExtension}/update{mediaTypeExtension}
Description
Allows one to enable or disable retweets and device notifications from the specified user.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "relationship": { "target": { "id_str": "1401881", "id": 1401881, "followed_by": true, "screen_name": "dougw", "following": true }, "source": { "can_dm": true, "blocking": false, "id_str": "819797", "all_replies": false, "want_retweets": true, "id": 819797, "marked_spam": false, "followed_by": true, "notifications_enabled": true, "screen_name": "episod", "following": true } } }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "relationship": { "properties": { "target": { "properties": { "id_str": { "type": "string" }, "id": { "type": "integer" }, "followed_by": { "type": "boolean" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" } }, "type": "object" }, "source": { "properties": { "can_dm": { "type": "boolean" }, "blocking": { "type": "boolean" }, "id_str": { "type": "string" }, "all_replies": { "type": "boolean" }, "want_retweets": { "type": "boolean" }, "id": { "type": "integer" }, "marked_spam": { "type": "boolean" }, "followed_by": { "type": "boolean" }, "notifications_enabled": { "type": "boolean" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" } }, "type": "object" } }, "type": "object" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /friendships{mediaTypeExtension}/show{mediaTypeExtension}
GET

#### friendships{mediaTypeExtension} show{mediaTypeExtension}

GET
/friendships{mediaTypeExtension}/show{mediaTypeExtension}
Description
Returns detailed information about the relationship between two arbitrary users.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- source_id (integer )
  The user_id of the subject user.
- source_screen_name (string )
  The screen_name of the subject user.
- target_id (integer )
  The user_id of the target user.
- target_screen_name (string )
  The screen_name of the target user.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "relationship": { "target": { "id_str": "1401881", "id": 1401881, "followed_by": true, "screen_name": "dougw", "following": true }, "source": { "can_dm": true, "blocking": false, "id_str": "819797", "all_replies": false, "want_retweets": true, "id": 819797, "marked_spam": false, "followed_by": true, "notifications_enabled": true, "screen_name": "episod", "following": true } } }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "relationship": { "properties": { "target": { "properties": { "id_str": { "type": "string" }, "id": { "type": "integer" }, "followed_by": { "type": "boolean" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" } }, "type": "object" }, "source": { "properties": { "can_dm": { "type": "boolean" }, "blocking": { "type": "boolean" }, "id_str": { "type": "string" }, "all_replies": { "type": "boolean" }, "want_retweets": { "type": "boolean" }, "id": { "type": "integer" }, "marked_spam": { "type": "boolean" }, "followed_by": { "type": "boolean" }, "notifications_enabled": { "type": "boolean" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" } }, "type": "object" } }, "type": "object" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /friends

#### friends

URl: /friends/ids{mediaTypeExtension}
GET

#### friends ids{mediaTypeExtension}

GET
/friends/ids{mediaTypeExtension}
Description
Returns a cursored collection of user IDs for every user the specified user is following (otherwise known as their "friends"). At this time, results are ordered with the most recent following first - however, this ordering is subject to unannounced change and eventual consistency issues. Results are given in groups of 5,000 user IDs and multiple "pages" of results can be navigated through using the next_cursor value in subsequent requests. See Using cursors to navigate collections for more information. This method is especially powerful when used in conjunction with 'GET users/lookup', a method that allows you to convert user IDs into full user objects in bulk.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- user_id (integer )
  The ID of the user for whom to return results for.
- screen_name (string )
  The screen name of the user for whom to return results for.
- cursor (integer )
  Causes the list of connections to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to be 5000 as suspended users are filtered out after connections are queried. If no cursor is provided, a value of -1 will be assumed, which is the first "page." The response from the API will include a previous_cursor and next_cursor to allow paging back and forth. See Using cursors to navigate collections for more information.
- stringify_ids (string )
  Many programming environments will not consume our Tweet ids due to their size. Provide this option to have ids returned as strings instead. More about Twitter IDs, JSON and Snowflake.
- count (integer )
  Specifies the number of IDs attempt retrieval of, up to a maximum of 5,000 per distinct request. The value of count is best thought of as a limit to the number of results to return. When using the count parameter with this method, it is wise to use a consistent count value across all requests to the same user's collection. Usage of this parameter is encouraged in environments where all 5,000 IDs constitutes too large of a response.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "ids": [ 657693, 183709371, 7588892, 38895958, 22891211, 9019482, 14488353, 11750202, 12249, 22915745, 1249881, 14927800, 1523501, 22548447, 15062340, 133031077, 17874544, 777925, 4265731, 27674040, 26123649, 9576402, 821958, 7852612, 819797, 1401881, 8285392, 9160152, 795649, 3191321, 783214 ], "previous_cursor_str": "0", "next_cursor": 0, "next_cursor_str": "0" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "previous_cursor": { "type": "integer" }, "ids": { "0": { "type": "integer" } }, "type": "array", "previous_cursor_str": { "type": "string" }, "next_cursor": { "type": "integer" }, "next_cursor_str": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /friends/list{mediaTypeExtension}
GET

#### friends list{mediaTypeExtension}

GET
/friends/list{mediaTypeExtension}
Description
Returns a cursored collection of user objects for every user the specified user is following (otherwise known as their "friends"). At this time, results are ordered with the most recent following first - however, this ordering is subject to unannounced change and eventual consistency issues. Results are given in groups of 20 users and multiple "pages" of results can be navigated through using the next_cursor value in subsequent requests. See Using cursors to navigate collections for more information.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- user_id (integer )
  The ID of the user for whom to return results for.
- screen_name (string )
  The screen name of the user for whom to return results for.
- cursor (integer )
  Causes the list of connections to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to be 5000 as suspended users are filtered out after connections are queried. If no cursor is provided, a value of -1 will be assumed, which is the first "page." The response from the API will include a previous_cursor and next_cursor to allow paging back and forth. See Using cursors to navigate collections for more information.
- skip_status (string )
  When set to either true, t or 1 statuses will not be included in the returned user objects.
- include_user_entities (string )
  The user object entities node will be disincluded when set to false.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "previous_cursor_str": "0", "next_cursor": 1333504313713127000, "users": [ { "profile_sidebar_fill_color": "252429", "profile_sidebar_border_color": "181A1E", "profile_background_tile": false, "name": "Sylvain Carle", "profile_image_url": "http://a0.twimg.com/profile_images/2838630046/4b82e286a659fae310012520f4f756bb_normal.png", "created_at": "Thu Jan 18 00:10:45 +0000 2007", "location": "San Francisco", "follow_request_sent": false, "profile_link_color": "2FC2EF", "is_translator": false, "id_str": "657693", "default_profile": false, "contributors_enabled": true, "favourites_count": 1973, "url": "http://afroginthevalley.com/", "profile_banner_url": "https://si0.twimg.com/profile_banners/657693/1353537845", "profile_image_url_https": "https://si0.twimg.com/profile_images/2838630046/4b82e286a659fae310012520f4f756bb_normal.png", "utc_offset": -18000, "id": 657693, "profile_use_background_image": true, "listed_count": 324, "profile_text_color": "666666", "lang": "en", "followers_count": 4993, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme9/bg.gif", "profile_background_color": "1A1B1F", "verified": false, "geo_enabled": true, "time_zone": "Eastern Time (US & Canada)", "description": "Developer Advocate at Twitter.\r\n\r\nInternet, opensource, media & geo/local geek.\r\n\r\nFollow @sylvain for LANG=FR.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme9/bg.gif", "statuses_count": 8504, "friends_count": 2743, "following": true, "screen_name": "froginthevalley" }, { "profile_sidebar_fill_color": "DDEEF6", "profile_sidebar_border_color": "C0DEED", "profile_background_tile": true, "name": "Site Streams Beta", "profile_image_url": "http://a0.twimg.com/profile_images/2284174702/1tyzesnfmqhqsl4xuf5a_normal.png", "created_at": "Fri Aug 27 18:04:38 +0000 2010", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": false, "id_str": "183709371", "default_profile": false, "contributors_enabled": true, "favourites_count": 0, "url": "http://twitter.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/183709371/1347395034", "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174702/1tyzesnfmqhqsl4xuf5a_normal.png", "utc_offset": null, "id": 183709371, "profile_use_background_image": true, "listed_count": 195, "profile_text_color": "333333", "lang": "en", "followers_count": 9732, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/656938621/vvhperynuny1q6em9i7k.png", "profile_background_color": "C0DEED", "verified": true, "geo_enabled": false, "time_zone": null, "description": "This account is no longer in use. Please see @twitterapi for announcements about the Sitestreams API.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/656938621/vvhperynuny1q6em9i7k.png", "statuses_count": 178, "friends_count": 5, "following": true, "screen_name": "sitestreams" }, { "profile_sidebar_fill_color": "C7E0FF", "profile_sidebar_border_color": "FFFFFF", "profile_background_tile": true, "name": "Arne Roomann-Kurrik", "profile_image_url": "http://a0.twimg.com/profile_images/24229162/arne001_normal.jpg", "created_at": "Thu Jul 19 15:58:07 +0000 2007", "location": "Scan Francesco", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": false, "id_str": "7588892", "default_profile": false, "contributors_enabled": false, "favourites_count": 798, "url": "http://start.roomanna.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/7588892/1347312754", "profile_image_url_https": "https://si0.twimg.com/profile_images/24229162/arne001_normal.jpg", "utc_offset": -28800, "id": 7588892, "profile_use_background_image": true, "listed_count": 172, "profile_text_color": "000000", "lang": "en", "followers_count": 3876, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/342542280/background7.png", "profile_background_color": "8FC1FF", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Developer Advocate at Twitter, practitioner of dark sandwich arts. ", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/342542280/background7.png", "statuses_count": 3245, "friends_count": 589, "following": true, "screen_name": "kurrik" }, { "profile_sidebar_fill_color": "252429", "profile_sidebar_border_color": "FFFFFF", "profile_background_tile": true, "name": "Sean Cook", "profile_image_url": "http://a0.twimg.com/profile_images/2757776645/23872cfcee4dc7279facb8fb0a6cb559_normal.png", "created_at": "Sat May 09 17:58:22 +0000 2009", "location": "San Francisco", "follow_request_sent": false, "profile_link_color": "2FC2EF", "is_translator": false, "id_str": "38895958", "default_profile": false, "contributors_enabled": true, "favourites_count": 698, "url": null, "profile_banner_url": "https://si0.twimg.com/profile_banners/38895958/1346803787", "profile_image_url_https": "https://si0.twimg.com/profile_images/2757776645/23872cfcee4dc7279facb8fb0a6cb559_normal.png", "utc_offset": -28800, "id": 38895958, "profile_use_background_image": false, "listed_count": 198, "profile_text_color": "666666", "lang": "en", "followers_count": 11191, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_color": "42454B", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png", "statuses_count": 2909, "friends_count": 1217, "following": true, "screen_name": "theSeanCook" }, { "profile_sidebar_fill_color": "C0DFEC", "profile_sidebar_border_color": "FFFFFF", "profile_background_tile": true, "name": "Ian Chan", "profile_image_url": "http://a0.twimg.com/profile_images/2467844172/image_normal.jpg", "created_at": "Thu Mar 05 06:42:32 +0000 2009", "location": "Toronto ✈ San Francisco", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": true, "id_str": "22891211", "default_profile": false, "contributors_enabled": true, "favourites_count": 3267, "url": "http://chanian.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/22891211/1348559711", "profile_image_url_https": "https://si0.twimg.com/profile_images/2467844172/image_normal.jpg", "utc_offset": -18000, "id": 22891211, "profile_use_background_image": true, "listed_count": 186, "profile_text_color": "333333", "lang": "en", "followers_count": 7356, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/663303208/kpzmxbnwvxk9cfr7hpdw.png", "profile_background_color": "022330", "verified": false, "geo_enabled": true, "time_zone": "Eastern Time (US & Canada)", "description": "Canadian, UofT Alumn, Platform Engineer for @twitter, poker player.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/663303208/kpzmxbnwvxk9cfr7hpdw.png", "statuses_count": 6892, "friends_count": 622, "following": true, "screen_name": "chanian" }, { "profile_sidebar_fill_color": "000B17", "profile_sidebar_border_color": "F7B565", "profile_background_tile": false, "name": "akashgarg", "profile_image_url": "http://a0.twimg.com/profile_images/1800189528/image1328232461_normal.png", "created_at": "Fri Sep 21 18:23:07 +0000 2007", "location": "San Francisco", "follow_request_sent": false, "profile_link_color": "448668", "is_translator": false, "id_str": "9019482", "default_profile": false, "contributors_enabled": false, "favourites_count": 57, "url": "http://www.linkedin.com/in/akashdgarg", "profile_banner_url": "https://si0.twimg.com/profile_banners/9019482/1348061531", "profile_image_url_https": "https://si0.twimg.com/profile_images/1800189528/image1328232461_normal.png", "utc_offset": -28800, "id": 9019482, "profile_use_background_image": false, "listed_count": 120, "profile_text_color": "004358", "lang": "en", "followers_count": 2649, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/378356748/x56a919dd9dbd34581a3f162af04a4e8.jpg", "profile_background_color": "001329", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Director of Engineering, Growth Team @ Twitter", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/378356748/x56a919dd9dbd34581a3f162af04a4e8.jpg", "statuses_count": 462, "friends_count": 1445, "following": true, "screen_name": "akashgarg" }, { "profile_sidebar_fill_color": "C0DFEC", "profile_sidebar_border_color": "A8C7F7", "profile_background_tile": false, "name": "Ben Ward", "profile_image_url": "http://a0.twimg.com/profile_images/1409204408/2011_normal.png", "created_at": "Mon Nov 13 13:39:24 +0000 2006", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": true, "id_str": "12249", "default_profile": false, "contributors_enabled": false, "favourites_count": 16749, "url": "http://benward.me", "profile_banner_url": "https://si0.twimg.com/profile_banners/12249/1348598804", "profile_image_url_https": "https://si0.twimg.com/profile_images/1409204408/2011_normal.png", "utc_offset": -28800, "id": 12249, "profile_use_background_image": true, "listed_count": 388, "profile_text_color": "333333", "lang": "en", "followers_count": 7982, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/637103983/474kwsozag6mi0hkvwmo.jpeg", "profile_background_color": "022330", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Frontend software engineer at @twitter, purveyor of shitty puns everywhere, @benwwward and @thepastrybox writer, @microformats community admin. Bit of a whiner.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/637103983/474kwsozag6mi0hkvwmo.jpeg", "statuses_count": 15542, "friends_count": 588, "following": true, "screen_name": "BenWard" }, { "profile_sidebar_fill_color": "F0F0F0", "profile_sidebar_border_color": "000000", "profile_background_tile": false, "name": "Kenneth P Kufluk", "profile_image_url": "http://a0.twimg.com/profile_images/2734520194/9e5843b95abce47b7056b17ce7bbc18f_normal.png", "created_at": "Thu Mar 05 13:05:04 +0000 2009", "location": "San Francisco, California", "follow_request_sent": false, "profile_link_color": "333333", "is_translator": false, "id_str": "22915745", "default_profile": false, "contributors_enabled": false, "favourites_count": 1280, "url": "http://kenneth.kufluk.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/22915745/1353469520", "profile_image_url_https": "https://si0.twimg.com/profile_images/2734520194/9e5843b95abce47b7056b17ce7bbc18f_normal.png", "utc_offset": -28800, "id": 22915745, "profile_use_background_image": true, "listed_count": 62, "profile_text_color": "333333", "lang": "en", "followers_count": 3925, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/173989056/silly_twitter_bg.jpg", "profile_background_color": "161712", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "The neth is essential.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/173989056/silly_twitter_bg.jpg", "statuses_count": 10009, "friends_count": 222, "following": true, "screen_name": "kpk" }, { "profile_sidebar_fill_color": "F6F6F6", "profile_sidebar_border_color": "FFFFFF", "profile_background_tile": false, "name": "Seth Bindernagel", "profile_image_url": "http://a0.twimg.com/profile_images/2867434205/c5bf4196b723e7d0494bd4b5ccf79346_normal.jpeg", "created_at": "Thu Mar 15 21:49:02 +0000 2007", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "FF3300", "is_translator": false, "id_str": "1249881", "default_profile": false, "contributors_enabled": true, "favourites_count": 278, "url": null, "profile_banner_url": "https://si0.twimg.com/profile_banners/1249881/1348078082", "profile_image_url_https": "https://si0.twimg.com/profile_images/2867434205/c5bf4196b723e7d0494bd4b5ccf79346_normal.jpeg", "utc_offset": -28800, "id": 1249881, "profile_use_background_image": true, "listed_count": 82, "profile_text_color": "333333", "lang": "en", "followers_count": 3341, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/698916047/dcd323b0502e46e4d3a337caf8694aef.jpeg", "profile_background_color": "709397", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "I work for Twitter and I love Cleveland Sports. https://about.me/binder", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/698916047/dcd323b0502e46e4d3a337caf8694aef.jpeg", "statuses_count": 1863, "friends_count": 690, "following": true, "screen_name": "binder" }, { "profile_sidebar_fill_color": "A0C5C7", "profile_sidebar_border_color": "86A4A6", "profile_background_tile": false, "name": "Jason Costa", "profile_image_url": "http://a0.twimg.com/profile_images/1751674923/new_york_beard_normal.jpg", "created_at": "Wed May 28 00:20:15 +0000 2008", "location": "", "follow_request_sent": false, "profile_link_color": "FF3300", "is_translator": true, "id_str": "14927800", "default_profile": false, "contributors_enabled": false, "favourites_count": 1053, "url": "http://www.jason-costa.blogspot.com/", "profile_image_url_https": "https://si0.twimg.com/profile_images/1751674923/new_york_beard_normal.jpg", "utc_offset": -28800, "id": 14927800, "profile_use_background_image": true, "listed_count": 161, "profile_text_color": "333333", "lang": "en", "followers_count": 11874, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme6/bg.gif", "profile_background_color": "709397", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Platform at Twitter", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme6/bg.gif", "statuses_count": 5745, "friends_count": 175, "following": true, "screen_name": "jasoncosta" }, { "profile_sidebar_fill_color": "FEFEFE", "profile_sidebar_border_color": "000000", "profile_background_tile": true, "name": "Connor Sears", "profile_image_url": "http://a0.twimg.com/profile_images/2659620048/aca7116831caaeb410b8b98be63c8874_normal.jpeg", "created_at": "Mon Mar 19 16:19:32 +0000 2007", "location": "Palo Alto", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": false, "id_str": "1523501", "default_profile": false, "contributors_enabled": false, "favourites_count": 2716, "url": "http://connorsears.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/1523501/1351629702", "profile_image_url_https": "https://si0.twimg.com/profile_images/2659620048/aca7116831caaeb410b8b98be63c8874_normal.jpeg", "utc_offset": -28800, "id": 1523501, "profile_use_background_image": true, "listed_count": 81, "profile_text_color": "333333", "lang": "en", "followers_count": 3055, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/698065178/00ca3a67587ddb2792d9b05a45cf42b1.jpeg", "profile_background_color": "262626", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Co-creator of Ratchet (@GoRatchet). Product Designer formerly at Twitter. I bless the rains down in Africa.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/698065178/00ca3a67587ddb2792d9b05a45cf42b1.jpeg", "statuses_count": 3992, "friends_count": 195, "following": true, "screen_name": "connors" }, { "profile_sidebar_fill_color": "C5DAE9", "profile_sidebar_border_color": "777777", "profile_background_tile": false, "name": "Arnaud Meunier", "profile_image_url": "http://a0.twimg.com/profile_images/1374353291/image_normal.jpg", "created_at": "Mon Mar 02 22:53:50 +0000 2009", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "21759B", "is_translator": true, "id_str": "22548447", "default_profile": false, "contributors_enabled": false, "favourites_count": 108, "url": "http://twitoaster.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/22548447/1348188118", "profile_image_url_https": "https://si0.twimg.com/profile_images/1374353291/image_normal.jpg", "utc_offset": -28800, "id": 22548447, "profile_use_background_image": false, "listed_count": 944, "profile_text_color": "555555", "lang": "en", "followers_count": 22315, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/107336160/twitter-background-twitoaster.png", "profile_background_color": "E4ECF0", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "French expat. Eng manager at Twitter.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/107336160/twitter-background-twitoaster.png", "statuses_count": 1926, "friends_count": 325, "following": true, "screen_name": "rno" }, { "profile_sidebar_fill_color": "DAECF4", "profile_sidebar_border_color": "C6E2EE", "profile_background_tile": true, "name": "Jeremy ⎋ Cloud", "profile_image_url": "http://a0.twimg.com/profile_images/2785231602/3697a603c0a067328d87beb15d2b59f0_normal.jpeg", "created_at": "Mon Jun 09 17:00:58 +0000 2008", "location": "Somerville, MA", "follow_request_sent": false, "profile_link_color": "1F98C7", "is_translator": false, "id_str": "15062340", "default_profile": false, "contributors_enabled": false, "favourites_count": 123, "url": "http://about.me/jeremy.cloud", "profile_banner_url": "https://si0.twimg.com/profile_banners/15062340/1351613822", "profile_image_url_https": "https://si0.twimg.com/profile_images/2785231602/3697a603c0a067328d87beb15d2b59f0_normal.jpeg", "utc_offset": -18000, "id": 15062340, "profile_use_background_image": true, "listed_count": 96, "profile_text_color": "663B12", "lang": "en", "followers_count": 3494, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/480149151/NSTexturedFullScreenBackgroundColor.png", "profile_background_color": "C6E2EE", "verified": false, "geo_enabled": true, "time_zone": "Eastern Time (US & Canada)", "description": "Former snake charmer. Engineer at Twitter. Father of @baby_cloud.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/480149151/NSTexturedFullScreenBackgroundColor.png", "statuses_count": 1514, "friends_count": 302, "following": true, "screen_name": "jeremycloud" }, { "profile_sidebar_fill_color": "F6FFD1", "profile_sidebar_border_color": "FFFFFF", "profile_background_tile": true, "name": "Glen D Sanford", "profile_image_url": "http://a0.twimg.com/profile_images/917780110/0629072227-00_normal.jpg", "created_at": "Wed Apr 14 20:59:58 +0000 2010", "location": "Alameda, CA", "follow_request_sent": false, "profile_link_color": "009999", "is_translator": false, "id_str": "133031077", "default_profile": false, "contributors_enabled": false, "favourites_count": 38, "url": "http://glen.nu", "profile_banner_url": "https://si0.twimg.com/profile_banners/133031077/1351918195", "profile_image_url_https": "https://si0.twimg.com/profile_images/917780110/0629072227-00_normal.jpg", "utc_offset": -28800, "id": 133031077, "profile_use_background_image": true, "listed_count": 56, "profile_text_color": "333333", "lang": "en", "followers_count": 2680, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/658791112/hxelotrdy3h7qga87mv1.jpeg", "profile_background_color": "131516", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Software Engineering Manager for @twittereng, fundamentally ok guy", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/658791112/hxelotrdy3h7qga87mv1.jpeg", "statuses_count": 1516, "friends_count": 147, "following": true, "screen_name": "9len" }, { "profile_sidebar_fill_color": "DDEEF6", "profile_sidebar_border_color": "C0DEED", "profile_background_tile": true, "name": "Support", "profile_image_url": "http://a0.twimg.com/profile_images/2320882833/2whv6cuhvbal751uss8u_normal.png", "created_at": "Thu Dec 04 18:51:57 +0000 2008", "location": "Twitter HQ", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": false, "id_str": "17874544", "default_profile": false, "contributors_enabled": true, "favourites_count": 45, "url": "http://support.twitter.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/17874544/1347394418", "profile_image_url_https": "https://si0.twimg.com/profile_images/2320882833/2whv6cuhvbal751uss8u_normal.png", "utc_offset": -32400, "id": 17874544, "profile_use_background_image": true, "listed_count": 11116, "profile_text_color": "333333", "lang": "en", "followers_count": 1901267, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/656929496/y6jd4l68p18hrm52f0ez.png", "profile_background_color": "C0DEED", "verified": true, "geo_enabled": true, "time_zone": "Alaska", "description": "Updates from Twitter User Support. We're unable to assist with account suspension/verification.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/656929496/y6jd4l68p18hrm52f0ez.png", "statuses_count": 2154, "friends_count": 30, "following": true, "screen_name": "Support" }, { "profile_sidebar_fill_color": "DDEEF6", "profile_sidebar_border_color": "C0DEED", "profile_background_tile": false, "name": "Matt Harris", "profile_image_url": "http://a0.twimg.com/profile_images/554181350/matt_normal.jpg", "created_at": "Sat Feb 17 20:49:54 +0000 2007", "location": "SFO/LHR/YVR/JAX/IAD", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": false, "id_str": "777925", "default_profile": true, "contributors_enabled": true, "favourites_count": 235, "url": "http://www.themattharris.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/777925/1351367661", "profile_image_url_https": "https://si0.twimg.com/profile_images/554181350/matt_normal.jpg", "utc_offset": -28800, "id": 777925, "profile_use_background_image": true, "listed_count": 304, "profile_text_color": "333333", "lang": "en", "followers_count": 8208, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "profile_background_color": "C0DEED", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Maybe the Nick Fury of @twitter. Married to @cindyli. Kryptonite hurts me.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "statuses_count": 4551, "friends_count": 433, "following": true, "screen_name": "themattharris" }, { "profile_sidebar_fill_color": "A0C5C7", "profile_sidebar_border_color": "FFFFFF", "profile_background_tile": false, "name": "April Underwood", "profile_image_url": "http://a0.twimg.com/profile_images/2623063815/image_normal.jpg", "created_at": "Thu Apr 12 00:11:07 +0000 2007", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "14A395", "is_translator": false, "id_str": "4265731", "default_profile": false, "contributors_enabled": true, "favourites_count": 3024, "url": "http://www.aprilunderwood.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/4265731/1352050638", "profile_image_url_https": "https://si0.twimg.com/profile_images/2623063815/image_normal.jpg", "utc_offset": -28800, "id": 4265731, "profile_use_background_image": false, "listed_count": 348, "profile_text_color": "333333", "lang": "en", "followers_count": 16976, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/662816188/cbyxvatdol1hg8r7c1qb.jpeg", "profile_background_color": "F4F5B1", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "You can't drink from a martini glass while sitting in a rocking chair. I work at @Twitter.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/662816188/cbyxvatdol1hg8r7c1qb.jpeg", "statuses_count": 8452, "friends_count": 1328, "following": true, "screen_name": "aunder" }, { "profile_sidebar_fill_color": "121212", "profile_sidebar_border_color": "000000", "profile_background_tile": false, "name": "Kelton Lynn", "profile_image_url": "http://a0.twimg.com/profile_images/384067053/n209356_35266280_356207_2_normal.jpg", "created_at": "Mon Mar 30 16:30:42 +0000 2009", "location": "San Francisco", "follow_request_sent": false, "profile_link_color": "999999", "is_translator": false, "id_str": "27674040", "default_profile": false, "contributors_enabled": true, "favourites_count": 421, "url": null, "profile_banner_url": "https://si0.twimg.com/profile_banners/27674040/1348163748", "profile_image_url_https": "https://si0.twimg.com/profile_images/384067053/n209356_35266280_356207_2_normal.jpg", "utc_offset": -28800, "id": 27674040, "profile_use_background_image": true, "listed_count": 174, "profile_text_color": "505050", "lang": "en", "followers_count": 10971, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/424627076/aged_planks_843_10949.jpg", "profile_background_color": "000000", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Mobile BizDev at Twitter, former Boulderite, bleed Cardinal, SF transplant, love athletics/competition, consumer tech, entrepreneurship, family/friends...life", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/424627076/aged_planks_843_10949.jpg", "statuses_count": 3166, "friends_count": 1216, "following": true, "screen_name": "keltonlynn" } ], "next_cursor_str": "1333504313713126852" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "previous_cursor": { "type": "integer" }, "previous_cursor_str": { "type": "string" }, "next_cursor": { "type": "integer" }, "users": { "0": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_sidebar_border_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "created_at": { "type": "string" }, "location": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "profile_link_color": { "type": "string" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "profile_banner_url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "notifications": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "profile_background_color": { "type": "string" }, "verified": { "type": "boolean" }, "geo_enabled": { "type": "boolean" }, "time_zone": { "type": "string" }, "description": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "friends_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" } }, "type": "object" } }, "type": "array", "next_cursor_str": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /followers

#### followers

URl: /followers/ids{mediaTypeExtension}
GET

#### followers ids{mediaTypeExtension}

GET
/followers/ids{mediaTypeExtension}
Description
Returns a cursored collection of user IDs for every user following the specified user. At this time, results are ordered with the most recent following first - however, this ordering is subject to unannounced change and eventual consistency issues. Results are given in groups of 5,000 user IDs and multiple "pages" of results can be navigated through using the next_cursor value in subsequent requests. See Using cursors to navigate collections for more information.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- user_id (integer )
  The ID of the user for whom to return results for.
- screen_name (string )
  The screen name of the user for whom to return results for.
- cursor (integer )
  Causes the list of connections to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to be 5000 as suspended users are filtered out after connections are queried. If no cursor is provided, a value of -1 will be assumed, which is the first "page." The response from the API will include a previous_cursor and next_cursor to allow paging back and forth. See Using cursors to navigate collections for more information.
- stringify_ids (string )
  Many programming environments will not consume our Tweet ids due to their size. Provide this option to have ids returned as strings instead. More about Twitter IDs, JSON and Snowflake.
- count (integer )
  Specifies the number of IDs attempt retrieval of, up to a maximum of 5,000 per distinct request. The value of count is best thought of as a limit to the number of results to return. When using the count parameter with this method, it is wise to use a consistent count value across all requests to the same user's collection. Usage of this parameter is encouraged in environments where all 5,000 IDs constitutes too large of a response.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "ids": [ 657693, 183709371, 7588892, 38895958, 22891211, 9019482, 14488353, 11750202, 12249, 22915745, 1249881, 14927800, 1523501, 22548447, 15062340, 133031077, 17874544, 777925, 4265731, 27674040, 26123649, 9576402, 821958, 7852612, 819797, 1401881, 8285392, 9160152, 795649, 3191321, 783214 ], "previous_cursor_str": "0", "next_cursor": 0, "next_cursor_str": "0" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "previous_cursor": { "type": "integer" }, "ids": { "0": { "type": "integer" } }, "type": "array", "previous_cursor_str": { "type": "string" }, "next_cursor": { "type": "integer" }, "next_cursor_str": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /followers/list{mediaTypeExtension}
GET

#### followers list{mediaTypeExtension}

GET
/followers/list{mediaTypeExtension}
Description
Returns a cursored collection of user objects for users following the specified user. At this time, results are ordered with the most recent following first - however, this ordering is subject to unannounced change and eventual consistency issues. Results are given in groups of 20 users and multiple "pages" of results can be navigated through using the next_cursor value in subsequent requests. See Using cursors to navigate collections for more information.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- user_id (integer )
  The ID of the user for whom to return results for.
- screen_name (string )
  The screen name of the user for whom to return results for.
- cursor (integer )
  Causes the list of connections to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to be 5000 as suspended users are filtered out after connections are queried. If no cursor is provided, a value of -1 will be assumed, which is the first "page." The response from the API will include a previous_cursor and next_cursor to allow paging back and forth. See Using cursors to navigate collections for more information.
- skip_status (string )
  When set to either true, t or 1 statuses will not be included in the returned user objects.
- include_user_entities (string )
  The user object entities node will be disincluded when set to false.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "previous_cursor_str": "0", "next_cursor": 1333504313713127000, "users": [ { "profile_sidebar_fill_color": "252429", "profile_sidebar_border_color": "181A1E", "profile_background_tile": false, "name": "Sylvain Carle", "profile_image_url": "http://a0.twimg.com/profile_images/2838630046/4b82e286a659fae310012520f4f756bb_normal.png", "created_at": "Thu Jan 18 00:10:45 +0000 2007", "location": "San Francisco", "follow_request_sent": false, "profile_link_color": "2FC2EF", "is_translator": false, "id_str": "657693", "default_profile": false, "contributors_enabled": true, "favourites_count": 1973, "url": "http://afroginthevalley.com/", "profile_banner_url": "https://si0.twimg.com/profile_banners/657693/1353537845", "profile_image_url_https": "https://si0.twimg.com/profile_images/2838630046/4b82e286a659fae310012520f4f756bb_normal.png", "utc_offset": -18000, "id": 657693, "profile_use_background_image": true, "listed_count": 324, "profile_text_color": "666666", "lang": "en", "followers_count": 4993, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme9/bg.gif", "profile_background_color": "1A1B1F", "verified": false, "geo_enabled": true, "time_zone": "Eastern Time (US & Canada)", "description": "Developer Advocate at Twitter.\r\n\r\nInternet, opensource, media & geo/local geek.\r\n\r\nFollow @sylvain for LANG=FR.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme9/bg.gif", "statuses_count": 8504, "friends_count": 2743, "following": true, "screen_name": "froginthevalley" }, { "profile_sidebar_fill_color": "DDEEF6", "profile_sidebar_border_color": "C0DEED", "profile_background_tile": true, "name": "Site Streams Beta", "profile_image_url": "http://a0.twimg.com/profile_images/2284174702/1tyzesnfmqhqsl4xuf5a_normal.png", "created_at": "Fri Aug 27 18:04:38 +0000 2010", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": false, "id_str": "183709371", "default_profile": false, "contributors_enabled": true, "favourites_count": 0, "url": "http://twitter.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/183709371/1347395034", "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174702/1tyzesnfmqhqsl4xuf5a_normal.png", "utc_offset": null, "id": 183709371, "profile_use_background_image": true, "listed_count": 195, "profile_text_color": "333333", "lang": "en", "followers_count": 9732, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/656938621/vvhperynuny1q6em9i7k.png", "profile_background_color": "C0DEED", "verified": true, "geo_enabled": false, "time_zone": null, "description": "This account is no longer in use. Please see @twitterapi for announcements about the Sitestreams API.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/656938621/vvhperynuny1q6em9i7k.png", "statuses_count": 178, "friends_count": 5, "following": true, "screen_name": "sitestreams" }, { "profile_sidebar_fill_color": "C7E0FF", "profile_sidebar_border_color": "FFFFFF", "profile_background_tile": true, "name": "Arne Roomann-Kurrik", "profile_image_url": "http://a0.twimg.com/profile_images/24229162/arne001_normal.jpg", "created_at": "Thu Jul 19 15:58:07 +0000 2007", "location": "Scan Francesco", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": false, "id_str": "7588892", "default_profile": false, "contributors_enabled": false, "favourites_count": 798, "url": "http://start.roomanna.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/7588892/1347312754", "profile_image_url_https": "https://si0.twimg.com/profile_images/24229162/arne001_normal.jpg", "utc_offset": -28800, "id": 7588892, "profile_use_background_image": true, "listed_count": 172, "profile_text_color": "000000", "lang": "en", "followers_count": 3876, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/342542280/background7.png", "profile_background_color": "8FC1FF", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Developer Advocate at Twitter, practitioner of dark sandwich arts. ", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/342542280/background7.png", "statuses_count": 3245, "friends_count": 589, "following": true, "screen_name": "kurrik" }, { "profile_sidebar_fill_color": "252429", "profile_sidebar_border_color": "FFFFFF", "profile_background_tile": true, "name": "Sean Cook", "profile_image_url": "http://a0.twimg.com/profile_images/2757776645/23872cfcee4dc7279facb8fb0a6cb559_normal.png", "created_at": "Sat May 09 17:58:22 +0000 2009", "location": "San Francisco", "follow_request_sent": false, "profile_link_color": "2FC2EF", "is_translator": false, "id_str": "38895958", "default_profile": false, "contributors_enabled": true, "favourites_count": 698, "url": null, "profile_banner_url": "https://si0.twimg.com/profile_banners/38895958/1346803787", "profile_image_url_https": "https://si0.twimg.com/profile_images/2757776645/23872cfcee4dc7279facb8fb0a6cb559_normal.png", "utc_offset": -28800, "id": 38895958, "profile_use_background_image": false, "listed_count": 198, "profile_text_color": "666666", "lang": "en", "followers_count": 11191, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_color": "42454B", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png", "statuses_count": 2909, "friends_count": 1217, "following": true, "screen_name": "theSeanCook" }, { "profile_sidebar_fill_color": "C0DFEC", "profile_sidebar_border_color": "FFFFFF", "profile_background_tile": true, "name": "Ian Chan", "profile_image_url": "http://a0.twimg.com/profile_images/2467844172/image_normal.jpg", "created_at": "Thu Mar 05 06:42:32 +0000 2009", "location": "Toronto ✈ San Francisco", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": true, "id_str": "22891211", "default_profile": false, "contributors_enabled": true, "favourites_count": 3267, "url": "http://chanian.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/22891211/1348559711", "profile_image_url_https": "https://si0.twimg.com/profile_images/2467844172/image_normal.jpg", "utc_offset": -18000, "id": 22891211, "profile_use_background_image": true, "listed_count": 186, "profile_text_color": "333333", "lang": "en", "followers_count": 7356, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/663303208/kpzmxbnwvxk9cfr7hpdw.png", "profile_background_color": "022330", "verified": false, "geo_enabled": true, "time_zone": "Eastern Time (US & Canada)", "description": "Canadian, UofT Alumn, Platform Engineer for @twitter, poker player.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/663303208/kpzmxbnwvxk9cfr7hpdw.png", "statuses_count": 6892, "friends_count": 622, "following": true, "screen_name": "chanian" }, { "profile_sidebar_fill_color": "000B17", "profile_sidebar_border_color": "F7B565", "profile_background_tile": false, "name": "akashgarg", "profile_image_url": "http://a0.twimg.com/profile_images/1800189528/image1328232461_normal.png", "created_at": "Fri Sep 21 18:23:07 +0000 2007", "location": "San Francisco", "follow_request_sent": false, "profile_link_color": "448668", "is_translator": false, "id_str": "9019482", "default_profile": false, "contributors_enabled": false, "favourites_count": 57, "url": "http://www.linkedin.com/in/akashdgarg", "profile_banner_url": "https://si0.twimg.com/profile_banners/9019482/1348061531", "profile_image_url_https": "https://si0.twimg.com/profile_images/1800189528/image1328232461_normal.png", "utc_offset": -28800, "id": 9019482, "profile_use_background_image": false, "listed_count": 120, "profile_text_color": "004358", "lang": "en", "followers_count": 2649, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/378356748/x56a919dd9dbd34581a3f162af04a4e8.jpg", "profile_background_color": "001329", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Director of Engineering, Growth Team @ Twitter", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/378356748/x56a919dd9dbd34581a3f162af04a4e8.jpg", "statuses_count": 462, "friends_count": 1445, "following": true, "screen_name": "akashgarg" }, { "profile_sidebar_fill_color": "C0DFEC", "profile_sidebar_border_color": "A8C7F7", "profile_background_tile": false, "name": "Ben Ward", "profile_image_url": "http://a0.twimg.com/profile_images/1409204408/2011_normal.png", "created_at": "Mon Nov 13 13:39:24 +0000 2006", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": true, "id_str": "12249", "default_profile": false, "contributors_enabled": false, "favourites_count": 16749, "url": "http://benward.me", "profile_banner_url": "https://si0.twimg.com/profile_banners/12249/1348598804", "profile_image_url_https": "https://si0.twimg.com/profile_images/1409204408/2011_normal.png", "utc_offset": -28800, "id": 12249, "profile_use_background_image": true, "listed_count": 388, "profile_text_color": "333333", "lang": "en", "followers_count": 7982, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/637103983/474kwsozag6mi0hkvwmo.jpeg", "profile_background_color": "022330", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Frontend software engineer at @twitter, purveyor of shitty puns everywhere, @benwwward and @thepastrybox writer, @microformats community admin. Bit of a whiner.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/637103983/474kwsozag6mi0hkvwmo.jpeg", "statuses_count": 15542, "friends_count": 588, "following": true, "screen_name": "BenWard" }, { "profile_sidebar_fill_color": "F0F0F0", "profile_sidebar_border_color": "000000", "profile_background_tile": false, "name": "Kenneth P Kufluk", "profile_image_url": "http://a0.twimg.com/profile_images/2734520194/9e5843b95abce47b7056b17ce7bbc18f_normal.png", "created_at": "Thu Mar 05 13:05:04 +0000 2009", "location": "San Francisco, California", "follow_request_sent": false, "profile_link_color": "333333", "is_translator": false, "id_str": "22915745", "default_profile": false, "contributors_enabled": false, "favourites_count": 1280, "url": "http://kenneth.kufluk.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/22915745/1353469520", "profile_image_url_https": "https://si0.twimg.com/profile_images/2734520194/9e5843b95abce47b7056b17ce7bbc18f_normal.png", "utc_offset": -28800, "id": 22915745, "profile_use_background_image": true, "listed_count": 62, "profile_text_color": "333333", "lang": "en", "followers_count": 3925, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/173989056/silly_twitter_bg.jpg", "profile_background_color": "161712", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "The neth is essential.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/173989056/silly_twitter_bg.jpg", "statuses_count": 10009, "friends_count": 222, "following": true, "screen_name": "kpk" }, { "profile_sidebar_fill_color": "F6F6F6", "profile_sidebar_border_color": "FFFFFF", "profile_background_tile": false, "name": "Seth Bindernagel", "profile_image_url": "http://a0.twimg.com/profile_images/2867434205/c5bf4196b723e7d0494bd4b5ccf79346_normal.jpeg", "created_at": "Thu Mar 15 21:49:02 +0000 2007", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "FF3300", "is_translator": false, "id_str": "1249881", "default_profile": false, "contributors_enabled": true, "favourites_count": 278, "url": null, "profile_banner_url": "https://si0.twimg.com/profile_banners/1249881/1348078082", "profile_image_url_https": "https://si0.twimg.com/profile_images/2867434205/c5bf4196b723e7d0494bd4b5ccf79346_normal.jpeg", "utc_offset": -28800, "id": 1249881, "profile_use_background_image": true, "listed_count": 82, "profile_text_color": "333333", "lang": "en", "followers_count": 3341, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/698916047/dcd323b0502e46e4d3a337caf8694aef.jpeg", "profile_background_color": "709397", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "I work for Twitter and I love Cleveland Sports. https://about.me/binder", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/698916047/dcd323b0502e46e4d3a337caf8694aef.jpeg", "statuses_count": 1863, "friends_count": 690, "following": true, "screen_name": "binder" }, { "profile_sidebar_fill_color": "A0C5C7", "profile_sidebar_border_color": "86A4A6", "profile_background_tile": false, "name": "Jason Costa", "profile_image_url": "http://a0.twimg.com/profile_images/1751674923/new_york_beard_normal.jpg", "created_at": "Wed May 28 00:20:15 +0000 2008", "location": "", "follow_request_sent": false, "profile_link_color": "FF3300", "is_translator": true, "id_str": "14927800", "default_profile": false, "contributors_enabled": false, "favourites_count": 1053, "url": "http://www.jason-costa.blogspot.com/", "profile_image_url_https": "https://si0.twimg.com/profile_images/1751674923/new_york_beard_normal.jpg", "utc_offset": -28800, "id": 14927800, "profile_use_background_image": true, "listed_count": 161, "profile_text_color": "333333", "lang": "en", "followers_count": 11874, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme6/bg.gif", "profile_background_color": "709397", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Platform at Twitter", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme6/bg.gif", "statuses_count": 5745, "friends_count": 175, "following": true, "screen_name": "jasoncosta" }, { "profile_sidebar_fill_color": "FEFEFE", "profile_sidebar_border_color": "000000", "profile_background_tile": true, "name": "Connor Sears", "profile_image_url": "http://a0.twimg.com/profile_images/2659620048/aca7116831caaeb410b8b98be63c8874_normal.jpeg", "created_at": "Mon Mar 19 16:19:32 +0000 2007", "location": "Palo Alto", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": false, "id_str": "1523501", "default_profile": false, "contributors_enabled": false, "favourites_count": 2716, "url": "http://connorsears.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/1523501/1351629702", "profile_image_url_https": "https://si0.twimg.com/profile_images/2659620048/aca7116831caaeb410b8b98be63c8874_normal.jpeg", "utc_offset": -28800, "id": 1523501, "profile_use_background_image": true, "listed_count": 81, "profile_text_color": "333333", "lang": "en", "followers_count": 3055, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/698065178/00ca3a67587ddb2792d9b05a45cf42b1.jpeg", "profile_background_color": "262626", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Co-creator of Ratchet (@GoRatchet). Product Designer formerly at Twitter. I bless the rains down in Africa.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/698065178/00ca3a67587ddb2792d9b05a45cf42b1.jpeg", "statuses_count": 3992, "friends_count": 195, "following": true, "screen_name": "connors" }, { "profile_sidebar_fill_color": "C5DAE9", "profile_sidebar_border_color": "777777", "profile_background_tile": false, "name": "Arnaud Meunier", "profile_image_url": "http://a0.twimg.com/profile_images/1374353291/image_normal.jpg", "created_at": "Mon Mar 02 22:53:50 +0000 2009", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "21759B", "is_translator": true, "id_str": "22548447", "default_profile": false, "contributors_enabled": false, "favourites_count": 108, "url": "http://twitoaster.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/22548447/1348188118", "profile_image_url_https": "https://si0.twimg.com/profile_images/1374353291/image_normal.jpg", "utc_offset": -28800, "id": 22548447, "profile_use_background_image": false, "listed_count": 944, "profile_text_color": "555555", "lang": "en", "followers_count": 22315, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/107336160/twitter-background-twitoaster.png", "profile_background_color": "E4ECF0", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "French expat. Eng manager at Twitter.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/107336160/twitter-background-twitoaster.png", "statuses_count": 1926, "friends_count": 325, "following": true, "screen_name": "rno" }, { "profile_sidebar_fill_color": "DAECF4", "profile_sidebar_border_color": "C6E2EE", "profile_background_tile": true, "name": "Jeremy ⎋ Cloud", "profile_image_url": "http://a0.twimg.com/profile_images/2785231602/3697a603c0a067328d87beb15d2b59f0_normal.jpeg", "created_at": "Mon Jun 09 17:00:58 +0000 2008", "location": "Somerville, MA", "follow_request_sent": false, "profile_link_color": "1F98C7", "is_translator": false, "id_str": "15062340", "default_profile": false, "contributors_enabled": false, "favourites_count": 123, "url": "http://about.me/jeremy.cloud", "profile_banner_url": "https://si0.twimg.com/profile_banners/15062340/1351613822", "profile_image_url_https": "https://si0.twimg.com/profile_images/2785231602/3697a603c0a067328d87beb15d2b59f0_normal.jpeg", "utc_offset": -18000, "id": 15062340, "profile_use_background_image": true, "listed_count": 96, "profile_text_color": "663B12", "lang": "en", "followers_count": 3494, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/480149151/NSTexturedFullScreenBackgroundColor.png", "profile_background_color": "C6E2EE", "verified": false, "geo_enabled": true, "time_zone": "Eastern Time (US & Canada)", "description": "Former snake charmer. Engineer at Twitter. Father of @baby_cloud.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/480149151/NSTexturedFullScreenBackgroundColor.png", "statuses_count": 1514, "friends_count": 302, "following": true, "screen_name": "jeremycloud" }, { "profile_sidebar_fill_color": "F6FFD1", "profile_sidebar_border_color": "FFFFFF", "profile_background_tile": true, "name": "Glen D Sanford", "profile_image_url": "http://a0.twimg.com/profile_images/917780110/0629072227-00_normal.jpg", "created_at": "Wed Apr 14 20:59:58 +0000 2010", "location": "Alameda, CA", "follow_request_sent": false, "profile_link_color": "009999", "is_translator": false, "id_str": "133031077", "default_profile": false, "contributors_enabled": false, "favourites_count": 38, "url": "http://glen.nu", "profile_banner_url": "https://si0.twimg.com/profile_banners/133031077/1351918195", "profile_image_url_https": "https://si0.twimg.com/profile_images/917780110/0629072227-00_normal.jpg", "utc_offset": -28800, "id": 133031077, "profile_use_background_image": true, "listed_count": 56, "profile_text_color": "333333", "lang": "en", "followers_count": 2680, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/658791112/hxelotrdy3h7qga87mv1.jpeg", "profile_background_color": "131516", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Software Engineering Manager for @twittereng, fundamentally ok guy", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/658791112/hxelotrdy3h7qga87mv1.jpeg", "statuses_count": 1516, "friends_count": 147, "following": true, "screen_name": "9len" }, { "profile_sidebar_fill_color": "DDEEF6", "profile_sidebar_border_color": "C0DEED", "profile_background_tile": true, "name": "Support", "profile_image_url": "http://a0.twimg.com/profile_images/2320882833/2whv6cuhvbal751uss8u_normal.png", "created_at": "Thu Dec 04 18:51:57 +0000 2008", "location": "Twitter HQ", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": false, "id_str": "17874544", "default_profile": false, "contributors_enabled": true, "favourites_count": 45, "url": "http://support.twitter.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/17874544/1347394418", "profile_image_url_https": "https://si0.twimg.com/profile_images/2320882833/2whv6cuhvbal751uss8u_normal.png", "utc_offset": -32400, "id": 17874544, "profile_use_background_image": true, "listed_count": 11116, "profile_text_color": "333333", "lang": "en", "followers_count": 1901267, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/656929496/y6jd4l68p18hrm52f0ez.png", "profile_background_color": "C0DEED", "verified": true, "geo_enabled": true, "time_zone": "Alaska", "description": "Updates from Twitter User Support. We're unable to assist with account suspension/verification.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/656929496/y6jd4l68p18hrm52f0ez.png", "statuses_count": 2154, "friends_count": 30, "following": true, "screen_name": "Support" }, { "profile_sidebar_fill_color": "DDEEF6", "profile_sidebar_border_color": "C0DEED", "profile_background_tile": false, "name": "Matt Harris", "profile_image_url": "http://a0.twimg.com/profile_images/554181350/matt_normal.jpg", "created_at": "Sat Feb 17 20:49:54 +0000 2007", "location": "SFO/LHR/YVR/JAX/IAD", "follow_request_sent": false, "profile_link_color": "0084B4", "is_translator": false, "id_str": "777925", "default_profile": true, "contributors_enabled": true, "favourites_count": 235, "url": "http://www.themattharris.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/777925/1351367661", "profile_image_url_https": "https://si0.twimg.com/profile_images/554181350/matt_normal.jpg", "utc_offset": -28800, "id": 777925, "profile_use_background_image": true, "listed_count": 304, "profile_text_color": "333333", "lang": "en", "followers_count": 8208, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "profile_background_color": "C0DEED", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Maybe the Nick Fury of @twitter. Married to @cindyli. Kryptonite hurts me.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "statuses_count": 4551, "friends_count": 433, "following": true, "screen_name": "themattharris" }, { "profile_sidebar_fill_color": "A0C5C7", "profile_sidebar_border_color": "FFFFFF", "profile_background_tile": false, "name": "April Underwood", "profile_image_url": "http://a0.twimg.com/profile_images/2623063815/image_normal.jpg", "created_at": "Thu Apr 12 00:11:07 +0000 2007", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "14A395", "is_translator": false, "id_str": "4265731", "default_profile": false, "contributors_enabled": true, "favourites_count": 3024, "url": "http://www.aprilunderwood.com", "profile_banner_url": "https://si0.twimg.com/profile_banners/4265731/1352050638", "profile_image_url_https": "https://si0.twimg.com/profile_images/2623063815/image_normal.jpg", "utc_offset": -28800, "id": 4265731, "profile_use_background_image": false, "listed_count": 348, "profile_text_color": "333333", "lang": "en", "followers_count": 16976, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/662816188/cbyxvatdol1hg8r7c1qb.jpeg", "profile_background_color": "F4F5B1", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "You can't drink from a martini glass while sitting in a rocking chair. I work at @Twitter.", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/662816188/cbyxvatdol1hg8r7c1qb.jpeg", "statuses_count": 8452, "friends_count": 1328, "following": true, "screen_name": "aunder" }, { "profile_sidebar_fill_color": "121212", "profile_sidebar_border_color": "000000", "profile_background_tile": false, "name": "Kelton Lynn", "profile_image_url": "http://a0.twimg.com/profile_images/384067053/n209356_35266280_356207_2_normal.jpg", "created_at": "Mon Mar 30 16:30:42 +0000 2009", "location": "San Francisco", "follow_request_sent": false, "profile_link_color": "999999", "is_translator": false, "id_str": "27674040", "default_profile": false, "contributors_enabled": true, "favourites_count": 421, "url": null, "profile_banner_url": "https://si0.twimg.com/profile_banners/27674040/1348163748", "profile_image_url_https": "https://si0.twimg.com/profile_images/384067053/n209356_35266280_356207_2_normal.jpg", "utc_offset": -28800, "id": 27674040, "profile_use_background_image": true, "listed_count": 174, "profile_text_color": "505050", "lang": "en", "followers_count": 10971, "protected": false, "notifications": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/424627076/aged_planks_843_10949.jpg", "profile_background_color": "000000", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Mobile BizDev at Twitter, former Boulderite, bleed Cardinal, SF transplant, love athletics/competition, consumer tech, entrepreneurship, family/friends...life", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/424627076/aged_planks_843_10949.jpg", "statuses_count": 3166, "friends_count": 1216, "following": true, "screen_name": "keltonlynn" } ], "next_cursor_str": "1333504313713126852" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "previous_cursor": { "type": "integer" }, "previous_cursor_str": { "type": "string" }, "next_cursor": { "type": "integer" }, "users": { "0": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_sidebar_border_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "created_at": { "type": "string" }, "location": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "profile_link_color": { "type": "string" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "profile_banner_url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "notifications": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "profile_background_color": { "type": "string" }, "verified": { "type": "boolean" }, "geo_enabled": { "type": "boolean" }, "time_zone": { "type": "string" }, "description": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "friends_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" } }, "type": "object" } }, "type": "array", "next_cursor_str": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /account

#### account

URl: /account/settings{mediaTypeExtension}
GET
POST

#### account settings{mediaTypeExtension}

GET
/account/settings{mediaTypeExtension}
Description
Returns settings (including current trend, geo and sleep time information) for the authenticating user.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "always_use_https": true, "discoverable_by_email": true, "geo_enabled": true, "language": "en", "protected": false, "screen_name": "theSeanCook", "show_all_inline_media": false, "sleep_time": { "enabled": false, "end_time": null, "start_time": null }, "time_zone": { "name": "Pacific Time (US & Canada)", "tzinfo_name": "America/Los_Angeles", "utc_offset": -28800 }, "trend_location": [ { "country": "United States", "countryCode": "US", "name": "Atlanta", "parentid": 23424977, "placeType": { "code": 7, "name": "Town" }, "url": "http://where.yahooapis.com/v1/place/2357024", "woeid": 2357024 } ], "use_cookie_personalization": true }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "always_use_https": { "type": "boolean" }, "discoverable_by_email": { "type": "boolean" }, "geo_enabled": { "type": "boolean" }, "language": { "type": "string" }, "protected": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" }, "sleep_time": { "properties": { "enabled": { "type": "boolean" }, "end_time": { "type": "string" }, "start_time": { "type": "string" } }, "type": "object" }, "time_zone": { "properties": { "name": { "type": "string" }, "tzinfo_name": { "type": "string" }, "utc_offset": { "type": "integer" } }, "type": "object" }, "trend_location": { "0": { "properties": { "country": { "type": "string" }, "countryCode": { "type": "string" }, "name": { "type": "string" }, "parentid": { "type": "integer" }, "placeType": { "properties": { "code": { "type": "integer" }, "name": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "woeid": { "type": "integer" } }, "type": "object" } }, "use_cookie_personalization": { "type": "boolean" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

POST
/account/settings{mediaTypeExtension}
Description
Updates the authenticating user's settings. While all parameters for this method are optional, at least one or more should be provided when executing this request.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "sleep_time": { "end_time": null, "enabled": false, "start_time": null }, "use_cookie_personalization": true, "trend_location": [ { "name": "San Francisco", "placeType": { "name": "Town", "code": 7 }, "woeid": 2487956, "country": "United States", "url": "http://where.yahooapis.com/v1/place/2487956", "countryCode": "US", "parentid": 23424977 } ], "language": "en", "discoverable_by_email": true, "always_use_https": true, "protected": false, "geo_enabled": true, "show_all_inline_media": false, "screen_name": "oauth_dancer" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "always_use_https": { "type": "boolean" }, "discoverable_by_email": { "type": "boolean" }, "geo_enabled": { "type": "boolean" }, "language": { "type": "string" }, "protected": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" }, "sleep_time": { "properties": { "enabled": { "type": "boolean" }, "end_time": { "type": "string" }, "start_time": { "type": "string" } }, "type": "object" }, "time_zone": { "properties": { "name": { "type": "string" }, "tzinfo_name": { "type": "string" }, "utc_offset": { "type": "integer" } }, "type": "object" }, "trend_location": { "0": { "properties": { "country": { "type": "string" }, "countryCode": { "type": "string" }, "name": { "type": "string" }, "parentid": { "type": "integer" }, "placeType": { "properties": { "code": { "type": "integer" }, "name": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "woeid": { "type": "integer" } }, "type": "object" } }, "use_cookie_personalization": { "type": "boolean" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /account/verify_credentials{mediaTypeExtension}
GET

#### account verify_credentials{mediaTypeExtension}

GET
/account/verify_credentials{mediaTypeExtension}
Description
Returns an HTTP 200 OK response code and a representation of the requesting user if authentication was successful; returns a 401 status code and an error message if not. Use this method to test if supplied user credentials are valid.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- skip_status (string )
  When set to either true, t or 1 statuses will not be included in the returned user objects.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "contributors_enabled": true, "created_at": "Sat May 09 17:58:22 +0000 2009", "default_profile": false, "default_profile_image": false, "description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ", "favourites_count": 588, "follow_request_sent": null, "followers_count": 10625, "following": null, "friends_count": 1181, "geo_enabled": true, "id": 38895958, "id_str": "38895958", "is_translator": false, "lang": "en", "listed_count": 190, "location": "San Francisco", "name": "Sean Cook", "notifications": null, "profile_background_color": "1A1B1F", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_link_color": "2FC2EF", "profile_sidebar_border_color": "181A1E", "profile_sidebar_fill_color": "252429", "profile_text_color": "666666", "profile_use_background_image": true, "protected": false, "screen_name": "theSeanCook", "show_all_inline_media": true, "status": { "contributors": null, "coordinates": { "coordinates": [ -122.45037293, 37.76484123 ], "type": "Point" }, "created_at": "Tue Aug 28 05:44:24 +0000 2012", "favorited": false, "geo": { "coordinates": [ 37.76484123, -122.45037293 ], "type": "Point" }, "id": 240323931419062270, "id_str": "240323931419062272", "in_reply_to_screen_name": "messl", "in_reply_to_status_id": 240316959173009400, "in_reply_to_status_id_str": "240316959173009410", "in_reply_to_user_id": 18707866, "in_reply_to_user_id_str": "18707866", "place": { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -122.45778216, 37.75932999 ], [ -122.44248216, 37.75932999 ], [ -122.44248216, 37.76752899 ], [ -122.45778216, 37.76752899 ] ] ], "type": "Polygon" }, "country": "United States", "country_code": "US", "full_name": "Ashbury Heights, San Francisco", "id": "866269c983527d5a", "name": "Ashbury Heights", "place_type": "neighborhood", "url": "http://api.twitter.com/1/geo/id/866269c983527d5a.json" }, "retweet_count": 0, "retweeted": false, "source": "<a href=\"http://twitter.com\" rel=\"nofollow\">Twitter for iPhone</a>", "text": "@messl congrats! So happy for all 3 of you.", "truncated": false }, "statuses_count": 2609, "time_zone": "Pacific Time (US & Canada)", "url": null, "utc_offset": -28800, "verified": false }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "contributors_enabled": { "type": "boolean" }, "created_at": { "type": "string" }, "default_profile": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "description": { "type": "string" }, "favourites_count": { "type": "integer" }, "follow_request_sent": { "type": "string" }, "followers_count": { "type": "integer" }, "following": { "type": "string" }, "friends_count": { "type": "integer" }, "geo_enabled": { "type": "boolean" }, "id": { "type": "integer" }, "id_str": { "type": "string" }, "is_translator": { "type": "boolean" }, "lang": { "type": "string" }, "listed_count": { "type": "integer" }, "location": { "type": "string" }, "name": { "type": "string" }, "notifications": { "type": "string" }, "profile_background_color": { "type": "string" }, "profile_background_image_url": { "type": "string" }, "profile_background_image_url_https": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_image_url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "profile_link_color": { "type": "string" }, "profile_sidebar_border_color": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_text_color": { "type": "string" }, "profile_use_background_image": { "type": "boolean" }, "protected": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" }, "status": { "properties": { "contributors": { "type": "string" }, "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "created_at": { "type": "string" }, "favorited": { "type": "boolean" }, "geo": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "id": { "type": "integer" }, "id_str": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "in_reply_to_status_id": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "in_reply_to_user_id": { "type": "integer" }, "in_reply_to_user_id_str": { "type": "string" }, "place": { "properties": { "attributes": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "_empty_": { "0": { "type": "number" } } } } }, "type": { "type": "string" } }, "type": "object" }, "country": { "type": "string" }, "country_code": { "type": "string" }, "full_name": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "place_type": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "retweet_count": { "type": "integer" }, "retweeted": { "type": "boolean" }, "source": { "type": "string" }, "text": { "type": "string" }, "truncated": { "type": "boolean" } }, "type": "object" }, "statuses_count": { "type": "integer" }, "time_zone": { "type": "string" }, "url": { "type": "string" }, "utc_offset": { "type": "integer" }, "verified": { "type": "boolean" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /account/update_delivery_device{mediaTypeExtension}
POST

#### account update_delivery_device{mediaTypeExtension}

POST
/account/update_delivery_device{mediaTypeExtension}
Description
Sets which device Twitter delivers updates to for the authenticating user. Sending none as the device parameter will disable SMS updates.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Examples are not provided by twitter docs.

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /account/update_profile{mediaTypeExtension}
POST

#### account update_profile{mediaTypeExtension}

POST
/account/update_profile{mediaTypeExtension}
Description
Sets values that users are able to set under the "Account" tab of their settings page. Only the parameters specified will be updated. While no specific parameter is required, at least one of these parameters should be provided when executing this method.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Profile updated.

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /account/update_profile_background_image{mediaTypeExtension}
POST

#### account update_profile_background_image{mediaTypeExtension}

POST
/account/update_profile_background_image{mediaTypeExtension}
Description
Updates the authenticating user's profile background image. This method can also be used to enable or disable the profile background image. Although each parameter is marked as optional, at least one of image, tile or use must be provided when making this request.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "contributors_enabled": false, "created_at": "Thu Aug 23 19:45:07 +0000 2012", "default_profile": false, "default_profile_image": false, "description": "Keep calm and test", "favourites_count": 0, "follow_request_sent": false, "followers_count": 0, "following": false, "friends_count": 10, "geo_enabled": true, "id": 776627022, "id_str": "776627022", "is_translator": false, "lang": "en", "listed_count": 0, "location": "San Francisco, CA", "name": "Sean Test", "notifications": false, "profile_background_color": "9AE4E8", "profile_background_image_url": "http://a0.twimg.com/images/themes/theme16/bg.gif", "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme16/bg.gif", "profile_background_tile": false, "profile_image_url": "http://a0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", "profile_image_url_https": "https://si0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", "profile_link_color": "0084B4", "profile_sidebar_border_color": "BDDCAD", "profile_sidebar_fill_color": "DDFFCC", "profile_text_color": "333333", "profile_use_background_image": true, "protected": false, "screen_name": "s0c1alm3dia", "show_all_inline_media": false, "statuses_count": 0, "time_zone": "Pacific Time (US & Canada)", "url": "http://cnn.com", "utc_offset": -28800, "verified": false }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "contributors_enabled": { "type": "boolean" }, "created_at": { "type": "string" }, "default_profile": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "description": { "type": "string" }, "favourites_count": { "type": "integer" }, "follow_request_sent": { "type": "boolean" }, "followers_count": { "type": "integer" }, "following": { "type": "boolean" }, "friends_count": { "type": "integer" }, "geo_enabled": { "type": "boolean" }, "id": { "type": "integer" }, "id_str": { "type": "string" }, "is_translator": { "type": "boolean" }, "lang": { "type": "string" }, "listed_count": { "type": "integer" }, "location": { "type": "string" }, "name": { "type": "string" }, "notifications": { "type": "boolean" }, "profile_background_color": { "type": "string" }, "profile_background_image_url": { "type": "string" }, "profile_background_image_url_https": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_image_url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "profile_link_color": { "type": "string" }, "profile_sidebar_border_color": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_text_color": { "type": "string" }, "profile_use_background_image": { "type": "boolean" }, "protected": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" }, "statuses_count": { "type": "integer" }, "time_zone": { "type": "string" }, "url": { "type": "string" }, "utc_offset": { "type": "integer" }, "verified": { "type": "boolean" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /account/update_profile_colors{mediaTypeExtension}
POST

#### account update_profile_colors{mediaTypeExtension}

POST
/account/update_profile_colors{mediaTypeExtension}
Description
Sets one or more hex values that control the color scheme of the authenticating user's profile page on twitter.com. Each parameter's value must be a valid hexidecimal value, and may be either three or six characters (ex: #fff or #ffffff).

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "contributors_enabled": false, "created_at": "Thu Aug 23 19:45:07 +0000 2012", "default_profile": false, "default_profile_image": false, "description": "Keep calm and test", "entities": { "description": { "urls": [] }, "url": { "urls": [ { "display_url": null, "expanded_url": null, "indices": [ 0, 14 ], "url": "http://cnn.com" } ] } }, "favourites_count": 0, "follow_request_sent": false, "followers_count": 0, "following": false, "friends_count": 10, "geo_enabled": true, "id": 776627022, "id_str": "776627022", "is_translator": false, "lang": "en", "listed_count": 0, "location": "San Francisco, CA", "name": "Mick Jagger", "notifications": false, "profile_background_color": "0000FF", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", "profile_image_url_https": "https://si0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", "profile_link_color": "000000", "profile_sidebar_border_color": "ff0000", "profile_sidebar_fill_color": "000000", "profile_text_color": "000000", "profile_use_background_image": false, "protected": false, "screen_name": "s0c1alm3dia", "show_all_inline_media": false, "statuses_count": 0, "time_zone": "Pacific Time (US & Canada)", "url": "http://cnn.com", "utc_offset": -28800, "verified": false }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "contributors_enabled": { "type": "boolean" }, "created_at": { "type": "string" }, "default_profile": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "description": { "type": "string" }, "entities": { "properties": { "description": { "urls": { }, "type": "array" }, "url": { "properties": { "urls": { "0": { "properties": { "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array", "url": { "type": "string" } }, "type": "object" } }, "type": "array" }, "type": "object" } }, "type": "object" }, "favourites_count": { "type": "integer" }, "follow_request_sent": { "type": "boolean" }, "followers_count": { "type": "integer" }, "following": { "type": "boolean" }, "friends_count": { "type": "integer" }, "geo_enabled": { "type": "boolean" }, "id": { "type": "integer" }, "id_str": { "type": "string" }, "is_translator": { "type": "boolean" }, "lang": { "type": "string" }, "listed_count": { "type": "integer" }, "location": { "type": "string" }, "name": { "type": "string" }, "notifications": { "type": "boolean" }, "profile_background_color": { "type": "string" }, "profile_background_image_url": { "type": "string" }, "profile_background_image_url_https": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_image_url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "profile_link_color": { "type": "string" }, "profile_sidebar_border_color": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_text_color": { "type": "string" }, "profile_use_background_image": { "type": "boolean" }, "protected": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" }, "statuses_count": { "type": "integer" }, "time_zone": { "type": "string" }, "url": { "type": "string" }, "utc_offset": { "type": "integer" }, "verified": { "type": "boolean" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /account/update_profile_image{mediaTypeExtension}
POST

#### account update_profile_image{mediaTypeExtension}

POST
/account/update_profile_image{mediaTypeExtension}
Description
Updates the authenticating user's profile image. Note that this method expects raw multipart data, not a URL to an image. This method asynchronously processes the uploaded file before updating the user's profile image URL. You can either update your local cache the next time you request the user's information, or, at least 5 seconds after uploading the image, ask for the updated URL using GET users/show.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "contributors_enabled": false, "created_at": "Thu Aug 23 19:45:07 +0000 2012", "default_profile": false, "default_profile_image": false, "description": "Keep calm and test", "favourites_count": 0, "follow_request_sent": false, "followers_count": 0, "following": false, "friends_count": 10, "geo_enabled": true, "id": 776627022, "id_str": "776627022", "is_translator": false, "lang": "en", "listed_count": 0, "location": "San Francisco, CA", "name": "Sean Test", "notifications": false, "profile_background_color": "000000", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", "profile_image_url_https": "https://si0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", "profile_link_color": "000000", "profile_sidebar_border_color": "000000", "profile_sidebar_fill_color": "000000", "profile_text_color": "000000", "profile_use_background_image": false, "protected": false, "screen_name": "s0c1alm3dia", "show_all_inline_media": false, "statuses_count": 0, "time_zone": "Pacific Time (US & Canada)", "url": "http://twitter.com", "utc_offset": -28800, "verified": false }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "contributors_enabled": { "type": "boolean" }, "created_at": { "type": "string" }, "default_profile": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "description": { "type": "string" }, "favourites_count": { "type": "integer" }, "follow_request_sent": { "type": "boolean" }, "followers_count": { "type": "integer" }, "following": { "type": "boolean" }, "friends_count": { "type": "integer" }, "geo_enabled": { "type": "boolean" }, "id": { "type": "integer" }, "id_str": { "type": "string" }, "is_translator": { "type": "boolean" }, "lang": { "type": "string" }, "listed_count": { "type": "integer" }, "location": { "type": "string" }, "name": { "type": "string" }, "notifications": { "type": "boolean" }, "profile_background_color": { "type": "string" }, "profile_background_image_url": { "type": "string" }, "profile_background_image_url_https": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_image_url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "profile_link_color": { "type": "string" }, "profile_sidebar_border_color": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_text_color": { "type": "string" }, "profile_use_background_image": { "type": "boolean" }, "protected": { "type": "boolean" }, "screen_name": "s0c1alm3dia", "show_all_inline_media": { "type": "boolean" }, "statuses_count": { "type": "integer" }, "time_zone": { "type": "string" }, "url": { "type": "string" }, "utc_offset": { "type": "integer" }, "verified": { "type": "boolean" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /account/update_profile_banner{mediaTypeExtension}
POST

#### account update_profile_banner{mediaTypeExtension}

POST
/account/update_profile_banner{mediaTypeExtension}
Description
Uploads a profile banner on behalf of the authenticating user. For best results, upload an <5MB image that is exactly 1252px by 626px. Images will be resized for a number of display options. Users with an uploaded profile banner will have a profile_banner_url node in their Users objects. More information about sizing variations can be found in User Profile Images and Banners and GET users/profile_banner. Profile banner images are processed asynchronously. The profile_banner_url and its variant sizes will not necessary be available directly after upload. Note: If providing any one of the height, width, offset_left, or offset_top parameters, you must provide all of the sizing parameters.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Profile banner image succesfully uploaded.

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  Either an image was not provided or the image data could not be processed.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  The image could not be resized or is too large.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

- ##### Http Status code
  201

  Profile banner image succesfully uploaded.

- ##### Http Status code
  202

  Profile banner image succesfully uploaded.

URl: /account/remove_profile_banner{mediaTypeExtension}
POST

#### account remove_profile_banner{mediaTypeExtension}

POST
/account/remove_profile_banner{mediaTypeExtension}
Description
Removes the uploaded profile banner for the authenticating user. Returns HTTP 200 upon success.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- #### Response

- ##### Http Status code
  200

  Profile banner deleted.

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /blocks

#### blocks

URl: /blocks/list{mediaTypeExtension}
GET

#### blocks list{mediaTypeExtension}

GET
/blocks/list{mediaTypeExtension}
Description
Returns a collection of user objects that the authenticating user is blocking. Important On October 15, 2012 this method will become cursored by default, altering the default response format. See Using cursors to navigate collections for more details on how cursoring works.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- skip_status (string )
  When set to either true, t or 1 statuses will not be included in the returned user objects.
- cursor (integer )
  Causes the list of blocked users to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to be 5000 as suspended users are filtered out after connections are queried. If no cursor is provided, a value of -1 will be assumed, which is the first "page." The response from the API will include a previous_cursor and next_cursor to allow paging back and forth. See Using cursors to navigate collections for more information.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "previous_cursor_str": "0", "next_cursor": 0, "users": [ { "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": false, "profile_sidebar_border_color": "C0DEED", "name": "Javier Heady \r", "created_at": "Thu Mar 01 00:16:47 +0000 2012", "profile_image_url": "http://a0.twimg.com/sticky/default_profile_images/default_profile_4_normal.png", "location": "", "is_translator": false, "follow_request_sent": false, "profile_link_color": "0084B4", "id_str": "509466276", "entities": { "description": { "urls": [ ] } }, "contributors_enabled": false, "favourites_count": 0, "url": null, "default_profile": true, "utc_offset": null, "profile_image_url_https": "https://si0.twimg.com/sticky/default_profile_images/default_profile_4_normal.png", "id": 509466276, "listed_count": 0, "profile_use_background_image": true, "followers_count": 0, "protected": false, "lang": "en", "profile_text_color": "333333", "profile_background_color": "C0DEED", "notifications": false, "verified": false, "description": "", "geo_enabled": false, "time_zone": null, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "friends_count": 0, "default_profile_image": true, "statuses_count": 4, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "following": false, "screen_name": "javierg3ong" } ], "next_cursor_str": "0" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "previous_cursor": { "type": "integer" }, "previous_cursor_str": { "type": "string" }, "next_cursor": { "type": "integer" }, "users": { "0": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "created_at": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "is_translator": { "type": "boolean" }, "follow_request_sent": { "type": "boolean" }, "profile_link_color": { "type": "string" }, "id_str": { "type": "string" }, "entities": { "properties": { "description": { "urls": { }, "type": "array" } }, "type": "object" }, "contributors_enabled": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "utc_offset": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "lang": { "type": "string" }, "profile_text_color": { "type": "string" }, "profile_background_color": { "type": "string" }, "notifications": { "type": "boolean" }, "verified": { "type": "boolean" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "time_zone": { "type": "string" }, "profile_background_image_url_https": { "type": "string" }, "friends_count": { "type": "integer" }, "default_profile_image": { "type": "boolean" }, "statuses_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" } }, "type": "object" } }, "next_cursor_str": "0" } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /blocks/ids{mediaTypeExtension}
GET

#### blocks ids{mediaTypeExtension}

GET
/blocks/ids{mediaTypeExtension}
Description
Returns an array of numeric user ids the authenticating user is blocking.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- stringify_ids (string )
  Many programming environments will not consume our ids due to their size. Provide this option to have ids returned as strings instead. Read more about Twitter IDs, JSON and Snowflake.
- cursor (integer )
  Causes the list of IDs to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to be 5000 as suspended users are filtered out after connections are queried. If no cursor is provided, a value of -1 will be assumed, which is the first "page." The response from the API will include a previous_cursor and next_cursor to allow paging back and forth. See Using cursors to navigate collections for more information.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "ids": [ "123" ], "previous_cursor_str": "0", "next_cursor": 0, "next_cursor_str": "0" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "previous_cursor": { "type": "integer" }, "ids": { "0": { "type": "string" } }, "type": "array", "previous_cursor_str": { "type": "string" }, "next_cursor": { "type": "integer" }, "next_cursor_str": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /blocks/create{mediaTypeExtension}
POST

#### blocks create{mediaTypeExtension}

POST
/blocks/create{mediaTypeExtension}
Description
Blocks the specified user from following the authenticating user. In addition the blocked user will not show in the authenticating users mentions or timeline (unless retweeted by another user). If a follow or friend relationship exists it is destroyed. Either screen_name or user_id must be provided.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "contributors_enabled": true, "created_at": "Sat May 09 17:58:22 +0000 2009", "default_profile": false, "default_profile_image": false, "description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ", "entities": { "description": { "urls": [] } }, "favourites_count": 586, "follow_request_sent": false, "followers_count": 10622, "following": false, "friends_count": 1181, "geo_enabled": true, "id": 38895958, "id_str": "38895958", "is_translator": false, "lang": "en", "listed_count": 190, "location": "San Francisco", "name": "Sean Cook", "notifications": false, "profile_background_color": "1A1B1F", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_link_color": "2FC2EF", "profile_sidebar_border_color": "181A1E", "profile_sidebar_fill_color": "252429", "profile_text_color": "666666", "profile_use_background_image": true, "protected": false, "screen_name": "theSeanCook", "show_all_inline_media": true, "statuses_count": 2609, "time_zone": "Pacific Time (US & Canada)", "url": null, "utc_offset": -28800, "verified": false }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "contributors_enabled": { "type": "boolean" }, "created_at": { "type": "string" }, "default_profile": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "description": { "type": "string" }, "entities": { "properties": { "description": { "properties": { "urls": { }, "type": "array" }, "type": "object" } }, "type": "object" }, "favourites_count": { "type": "integer" }, "follow_request_sent": { "type": "boolean" }, "followers_count": { "type": "integer" }, "following": { "type": "boolean" }, "friends_count": { "type": "integer" }, "geo_enabled": { "type": "boolean" }, "id": { "type": "integer" }, "id_str": { "type": "string" }, "is_translator": { "type": "boolean" }, "lang": { "type": "string" }, "listed_count": { "type": "integer" }, "location": { "type": "string" }, "name": { "type": "string" }, "notifications": { "type": "boolean" }, "profile_background_color": { "type": "string" }, "profile_background_image_url": { "type": "string" }, "profile_background_image_url_https": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_image_url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "profile_link_color": { "type": "string" }, "profile_sidebar_border_color": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_text_color": { "type": "string" }, "profile_use_background_image": { "type": "boolean" }, "protected": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" }, "statuses_count": { "type": "integer" }, "time_zone": { "type": "string" }, "url": { "type": "string" }, "utc_offset": { "type": "integer" }, "verified": { "type": "boolean" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /blocks/destroy{mediaTypeExtension}
POST

#### blocks destroy{mediaTypeExtension}

POST
/blocks/destroy{mediaTypeExtension}
Description
Un-blocks the user specified in the ID parameter for the authenticating user. Returns the un-blocked user in the requested format when successful. If relationships existed before the block was instated, they will not be restored. One of screen_name or id must be provided.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "contributors_enabled": true, "created_at": "Sat May 09 17:58:22 +0000 2009", "default_profile": false, "default_profile_image": false, "description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ", "entities": { "description": { "urls": [] } }, "favourites_count": 586, "follow_request_sent": false, "followers_count": 10622, "following": false, "friends_count": 1181, "geo_enabled": true, "id": 38895958, "id_str": "38895958", "is_translator": false, "lang": "en", "listed_count": 190, "location": "San Francisco", "name": "Sean Cook", "notifications": false, "profile_background_color": "1A1B1F", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "profile_link_color": "2FC2EF", "profile_sidebar_border_color": "181A1E", "profile_sidebar_fill_color": "252429", "profile_text_color": "666666", "profile_use_background_image": true, "protected": false, "screen_name": "theSeanCook", "show_all_inline_media": true, "statuses_count": 2609, "time_zone": "Pacific Time (US & Canada)", "url": null, "utc_offset": -28800, "verified": false }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "contributors_enabled": { "type": "boolean" }, "created_at": { "type": "string" }, "default_profile": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "description": { "type": "string" }, "entities": { "properties": { "description": { "properties": { "urls": { }, "type": "array" }, "type": "object" } }, "type": "object" }, "favourites_count": { "type": "integer" }, "follow_request_sent": { "type": "boolean" }, "followers_count": { "type": "integer" }, "following": { "type": "boolean" }, "friends_count": { "type": "integer" }, "geo_enabled": { "type": "boolean" }, "id": { "type": "integer" }, "id_str": { "type": "string" }, "is_translator": { "type": "boolean" }, "lang": { "type": "string" }, "listed_count": { "type": "integer" }, "location": { "type": "string" }, "name": { "type": "string" }, "notifications": { "type": "boolean" }, "profile_background_color": { "type": "string" }, "profile_background_image_url": { "type": "string" }, "profile_background_image_url_https": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_image_url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "profile_link_color": { "type": "string" }, "profile_sidebar_border_color": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_text_color": { "type": "string" }, "profile_use_background_image": { "type": "boolean" }, "protected": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" }, "statuses_count": { "type": "integer" }, "time_zone": { "type": "string" }, "url": { "type": "string" }, "utc_offset": { "type": "integer" }, "verified": { "type": "boolean" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /users

#### users

URl: /users/lookup{mediaTypeExtension}
GET

#### users lookup{mediaTypeExtension}

GET
/users/lookup{mediaTypeExtension}
Description
Returns fully-hydrated user objects for up to 100 users per request, as specified by comma-separated values passed to the user_id and/or screen_name parameters. This method is especially useful when used in conjunction with collections of user IDs returned from GET friends/ids and GET followers/ids. GET users/show is used to retrieve a single user object.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- screen_name (string )
  A comma separated list of screen names, up to 100 are allowed in a single request. You are strongly encouraged to use a POST for larger (up to 100 screen names) requests.

  ###### Example

      twitterapi,twitter

- user_id (string )
  A comma separated list of user IDs, up to 100 are allowed in a single request. You are strongly encouraged to use a POST for larger requests.

  ###### Example

      7832146253282

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "name": "Twitter API", "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": false, "profile_sidebar_border_color": "C0DEED", "profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "location": "San Francisco, CA", "created_at": "Wed May 23 06:01:13 +0000 2007", "follow_request_sent": false, "id_str": "6253282", "profile_link_color": "0084B4", "is_translator": false, "default_profile": true, "favourites_count": 24, "contributors_enabled": true, "url": "http://dev.twitter.com", "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "utc_offset": -28800, "id": 6253282, "profile_use_background_image": true, "listed_count": 10713, "profile_text_color": "333333", "lang": "en", "followers_count": 1198334, "protected": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "geo_enabled": true, "description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.", "profile_background_color": "C0DEED", "verified": true, "notifications": false, "time_zone": "Pacific Time (US & Canada)", "statuses_count": 3331, "status": { "coordinates": null, "created_at": "Fri Aug 24 16:15:49 +0000 2012", "favorited": false, "truncated": false, "id_str": "239033279343382529", "in_reply_to_user_id_str": "134727529", "text": "@gregclermont no, there is not. ^TS", "contributors": null, "retweet_count": 0, "id": 239033279343382529, "in_reply_to_status_id_str": "238933943146131456", "geo": null, "retweeted": false, "in_reply_to_user_id": 134727529, "place": null, "source": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>", "in_reply_to_screen_name": "gregclermont", "in_reply_to_status_id": 238933943146131456 }, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "default_profile_image": false, "friends_count": 31, "screen_name": "twitterapi", "following": true, "show_all_inline_media": false }, { "name": "Twitter", "profile_sidebar_fill_color": "F6F6F6", "profile_background_tile": true, "profile_sidebar_border_color": "EEEEEE", "profile_image_url": "http://a0.twimg.com/profile_images/2284174758/v65oai7fxn47qv9nectx_normal.png", "location": "San Francisco, CA", "created_at": "Tue Feb 20 14:35:54 +0000 2007", "follow_request_sent": false, "id_str": "783214", "profile_link_color": "038543", "is_translator": false, "default_profile": false, "favourites_count": 17, "contributors_enabled": true, "url": "http://blog.twitter.com/", "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174758/v65oai7fxn47qv9nectx_normal.png", "utc_offset": -28800, "id": 783214, "profile_banner_url": "https://si0.twimg.com/brand_banners/twitter/1323368512/live", "profile_use_background_image": true, "listed_count": 72534, "profile_text_color": "333333", "lang": "en", "followers_count": 12788713, "protected": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/378245879/Twitter_1544x2000.png", "geo_enabled": true, "description": "Always wondering what's happening. ", "profile_background_color": "ACDED6", "verified": true, "notifications": false, "time_zone": "Pacific Time (US & Canada)", "statuses_count": 1379, "status": { "coordinates": null, "created_at": "Tue Aug 21 19:04:00 +0000 2012", "favorited": false, "truncated": false, "id_str": "237988442338897920", "retweeted_status": { "coordinates": null, "created_at": "Tue Aug 21 18:51:44 +0000 2012", "favorited": false, "truncated": false, "id_str": "237985351858278400", "in_reply_to_user_id_str": null, "text": "Arijit Guha fought for insurance coverage, and won.\n http://t.co/ZvQ6fU2O #twitterstories http://t.co/bVYPNnV7", "contributors": [ 16896060 ], "retweet_count": 118, "id": 237985351858278400, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "source": "web", "in_reply_to_screen_name": null, "in_reply_to_status_id": null }, "in_reply_to_user_id_str": null, "text": "RT @TwitterStories: Arijit Guha fought for insurance coverage, and won.\n http://t.co/ZvQ6fU2O #twitterstories http://t.co/bVYPNnV7", "contributors": null, "retweet_count": 118, "id": 237988442338897920, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "source": "web", "in_reply_to_screen_name": null, "in_reply_to_status_id": null }, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/378245879/Twitter_1544x2000.png", "default_profile_image": false, "friends_count": 1195, "screen_name": "twitter", "following": true, "show_all_inline_media": true } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "is_translator": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "description": { "type": "string" }, "profile_background_color": { "type": "string" }, "verified": { "type": "boolean" }, "notifications": { "type": "boolean" }, "time_zone": { "type": "string" }, "statuses_count": { "type": "integer" }, "status": { "properties": { "coordinates": { "type": "string" }, "created_at": { "type": "string" }, "favorited": { "type": "boolean" }, "truncated": { "type": "boolean" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "text": { "type": "string" }, "contributors": { "type": "string" }, "retweet_count": { "type": "integer" }, "id": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "integer" }, "place": { "type": "string" }, "source": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "in_reply_to_status_id": { "type": "integer" } }, "type": "object" }, "profile_background_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /users/show{mediaTypeExtension}
GET

#### users show{mediaTypeExtension}

GET
/users/show{mediaTypeExtension}
Description
Returns a variety of information about the user specified by the required user_id or screen_name parameter. The author's most recent Tweet will be returned inline when possible. GET users/lookup is used to retrieve a bulk collection of user objects. You must be following a protected user to be able to see their most recent Tweet. If you don't follow a protected user, the users Tweet will be removed. A Tweet will not always be returned in the current_status field.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- user_id (integer )
  The ID of the user for whom to return results for. Either an id or screen_name is required for this method.
- screen_name (string )
  The screen name of the user for whom to return results for. Either a id or screen_name is required for this method.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "profile_sidebar_fill_color": "F8FCF2", "profile_sidebar_border_color": "547980", "profile_background_tile": true, "name": "Ryan Sarver", "profile_image_url": "http://a0.twimg.com/profile_images/1777569006/image1327396628_normal.png", "created_at": "Mon Feb 26 18:05:55 +0000 2007", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "547980", "is_translator": false, "id_str": "795649", "default_profile": false, "contributors_enabled": true, "favourites_count": 3162, "url": null, "profile_image_url_https": "https://si0.twimg.com/profile_images/1777569006/image1327396628_normal.png", "utc_offset": -28800, "id": 795649, "profile_use_background_image": true, "listed_count": 1586, "profile_text_color": "594F4F", "lang": "en", "followers_count": 276334, "protected": false, "notifications": true, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/113854313/xa60e82408188860c483d73444d53e21.png", "profile_background_color": "45ADA8", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Director, Platform at Twitter. Detroit and Boston export. Foodie and over-the-hill hockey player. @devon's lesser half", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/113854313/xa60e82408188860c483d73444d53e21.png", "status": { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Sat Aug 25 19:33:11 +0000 2012", "retweeted_status": { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Sat Aug 25 19:20:36 +0000 2012", "id_str": "239442171466493953", "entities": { "urls": [ { "expanded_url": "http://nbcnews.to/NtkRTJ", "url": "http://t.co/f8ivBrVd", "indices": [ 102, 122 ], "display_url": "nbcnews.to/NtkRTJ" } ], "hashtags": [], "user_mentions": [] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "Neil Armstrong has died at the age of 82 from complications from heart operations he had 3 weeks ago. http://t.co/f8ivBrVd", "retweet_count": 112, "in_reply_to_status_id_str": null, "id": 239442171466493950, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "in_reply_to_screen_name": null, "source": "web", "in_reply_to_status_id": null }, "id_str": "239445335481647105", "entities": { "urls": [ { "expanded_url": "http://nbcnews.to/NtkRTJ", "url": "http://t.co/f8ivBrVd", "indices": [ 115, 135 ], "display_url": "nbcnews.to/NtkRTJ" } ], "hashtags": [], "user_mentions": [ { "name": "NBC News", "id_str": "14173315", "id": 14173315, "indices": [ 3, 11 ], "screen_name": "NBCNews" } ] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "RT @NBCNews: Neil Armstrong has died at the age of 82 from complications from heart operations he had 3 weeks ago. http://t.co/f8ivBrVd", "retweet_count": 112, "in_reply_to_status_id_str": null, "id": 239445335481647100, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "in_reply_to_screen_name": null, "source": "<a href=\"http://twitter.com\" rel=\"nofollow\">Twitter for iPhone</a>", "in_reply_to_status_id": null }, "statuses_count": 13728, "friends_count": 1780, "following": true, "show_all_inline_media": true, "screen_name": "rsarver" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "is_translator": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "description": { "type": "string" }, "profile_background_color": { "type": "string" }, "verified": { "type": "boolean" }, "notifications": { "type": "boolean" }, "time_zone": { "type": "string" }, "statuses_count": { "type": "integer" }, "status": { "properties": { "coordinates": { "type": "string" }, "created_at": { "type": "string" }, "favorited": { "type": "boolean" }, "truncated": { "type": "boolean" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "text": { "type": "string" }, "contributors": { "type": "string" }, "retweet_count": { "type": "integer" }, "id": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "integer" }, "place": { "type": "string" }, "source": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "in_reply_to_status_id": { "type": "integer" } }, "type": "object" }, "profile_background_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /users/search{mediaTypeExtension}
GET

#### users search{mediaTypeExtension}

GET
/users/search{mediaTypeExtension}
Description
Provides a simple, relevance-based search interface to public user accounts on Twitter. Try querying by topical interest, full name, company name, location, or other criteria. Exact match searches are not supported. Only the first 1,000 matching results are available.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- q (string )
  The search query to run against people search.
- page (string )
  Specifies the page of results to retrieve.
- count (integer )
  The number of potential user results to retrieve per page. This value has a maximum of 20.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "profile_sidebar_fill_color": "F8FCF2", "profile_sidebar_border_color": "547980", "profile_background_tile": true, "name": "Ryan Sarver", "profile_image_url": "http://a0.twimg.com/profile_images/1777569006/image1327396628_normal.png", "created_at": "Mon Feb 26 18:05:55 +0000 2007", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "547980", "is_translator": false, "id_str": "795649", "default_profile": false, "contributors_enabled": true, "favourites_count": 3162, "url": null, "profile_image_url_https": "https://si0.twimg.com/profile_images/1777569006/image1327396628_normal.png", "utc_offset": -28800, "id": 795649, "profile_use_background_image": true, "listed_count": 1586, "profile_text_color": "594F4F", "lang": "en", "followers_count": 276334, "protected": false, "notifications": true, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/113854313/xa60e82408188860c483d73444d53e21.png", "profile_background_color": "45ADA8", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Director, Platform at Twitter. Detroit and Boston export. Foodie and over-the-hill hockey player. @devon's lesser half", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/113854313/xa60e82408188860c483d73444d53e21.png", "status": { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Sat Aug 25 19:33:11 +0000 2012", "retweeted_status": { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Sat Aug 25 19:20:36 +0000 2012", "id_str": "239442171466493953", "entities": { "urls": [ { "expanded_url": "http://nbcnews.to/NtkRTJ", "url": "http://t.co/f8ivBrVd", "indices": [ 102, 122 ], "display_url": "nbcnews.to/NtkRTJ" } ], "hashtags": [], "user_mentions": [] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "Neil Armstrong has died at the age of 82 from complications from heart operations he had 3 weeks ago. http://t.co/f8ivBrVd", "retweet_count": 112, "in_reply_to_status_id_str": null, "id": 239442171466493950, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "in_reply_to_screen_name": null, "source": "web", "in_reply_to_status_id": null }, "id_str": "239445335481647105", "entities": { "urls": [ { "expanded_url": "http://nbcnews.to/NtkRTJ", "url": "http://t.co/f8ivBrVd", "indices": [ 115, 135 ], "display_url": "nbcnews.to/NtkRTJ" } ], "hashtags": [], "user_mentions": [ { "name": "NBC News", "id_str": "14173315", "id": 14173315, "indices": [ 3, 11 ], "screen_name": "NBCNews" } ] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "RT @NBCNews: Neil Armstrong has died at the age of 82 from complications from heart operations he had 3 weeks ago. http://t.co/f8ivBrVd", "retweet_count": 112, "in_reply_to_status_id_str": null, "id": 239445335481647100, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "in_reply_to_screen_name": null, "source": "<a href=\"http://twitter.com\" rel=\"nofollow\">Twitter for iPhone</a>", "in_reply_to_status_id": null }, "statuses_count": 13728, "friends_count": 1780, "following": true, "show_all_inline_media": true, "screen_name": "rsarver" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "is_translator": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "description": { "type": "string" }, "profile_background_color": { "type": "string" }, "verified": { "type": "boolean" }, "notifications": { "type": "boolean" }, "time_zone": { "type": "string" }, "statuses_count": { "type": "integer" }, "status": { "properties": { "coordinates": { "type": "string" }, "created_at": { "type": "string" }, "favorited": { "type": "boolean" }, "truncated": { "type": "boolean" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "text": { "type": "string" }, "contributors": { "type": "string" }, "retweet_count": { "type": "integer" }, "id": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "integer" }, "place": { "type": "string" }, "source": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "in_reply_to_status_id": { "type": "integer" } }, "type": "object" }, "profile_background_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /users/contributees{mediaTypeExtension}
GET

#### users contributees{mediaTypeExtension}

GET
/users/contributees{mediaTypeExtension}
Description
Returns a collection of users that the specified user can "contribute" to.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- user_id (integer )
  The ID of the user for whom to return results for. Helpful for disambiguating when a valid user ID is also a valid screen name.
- screen_name (string )
  The screen name of the user for whom to return results for.
- skip_status (string )
  When set to either true, t or 1 statuses will not be included in the returned user objects.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "profile_sidebar_fill_color": "F8FCF2", "profile_sidebar_border_color": "547980", "profile_background_tile": true, "name": "Ryan Sarver", "profile_image_url": "http://a0.twimg.com/profile_images/1777569006/image1327396628_normal.png", "created_at": "Mon Feb 26 18:05:55 +0000 2007", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "547980", "is_translator": false, "id_str": "795649", "default_profile": false, "contributors_enabled": true, "favourites_count": 3162, "url": null, "profile_image_url_https": "https://si0.twimg.com/profile_images/1777569006/image1327396628_normal.png", "utc_offset": -28800, "id": 795649, "profile_use_background_image": true, "listed_count": 1586, "profile_text_color": "594F4F", "lang": "en", "followers_count": 276334, "protected": false, "notifications": true, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/113854313/xa60e82408188860c483d73444d53e21.png", "profile_background_color": "45ADA8", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Director, Platform at Twitter. Detroit and Boston export. Foodie and over-the-hill hockey player. @devon's lesser half", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/113854313/xa60e82408188860c483d73444d53e21.png", "status": { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Sat Aug 25 19:33:11 +0000 2012", "retweeted_status": { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Sat Aug 25 19:20:36 +0000 2012", "id_str": "239442171466493953", "entities": { "urls": [ { "expanded_url": "http://nbcnews.to/NtkRTJ", "url": "http://t.co/f8ivBrVd", "indices": [ 102, 122 ], "display_url": "nbcnews.to/NtkRTJ" } ], "hashtags": [], "user_mentions": [] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "Neil Armstrong has died at the age of 82 from complications from heart operations he had 3 weeks ago. http://t.co/f8ivBrVd", "retweet_count": 112, "in_reply_to_status_id_str": null, "id": 239442171466493950, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "in_reply_to_screen_name": null, "source": "web", "in_reply_to_status_id": null }, "id_str": "239445335481647105", "entities": { "urls": [ { "expanded_url": "http://nbcnews.to/NtkRTJ", "url": "http://t.co/f8ivBrVd", "indices": [ 115, 135 ], "display_url": "nbcnews.to/NtkRTJ" } ], "hashtags": [], "user_mentions": [ { "name": "NBC News", "id_str": "14173315", "id": 14173315, "indices": [ 3, 11 ], "screen_name": "NBCNews" } ] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "RT @NBCNews: Neil Armstrong has died at the age of 82 from complications from heart operations he had 3 weeks ago. http://t.co/f8ivBrVd", "retweet_count": 112, "in_reply_to_status_id_str": null, "id": 239445335481647100, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "in_reply_to_screen_name": null, "source": "<a href=\"http://twitter.com\" rel=\"nofollow\">Twitter for iPhone</a>", "in_reply_to_status_id": null }, "statuses_count": 13728, "friends_count": 1780, "following": true, "show_all_inline_media": true, "screen_name": "rsarver" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "is_translator": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "description": { "type": "string" }, "profile_background_color": { "type": "string" }, "verified": { "type": "boolean" }, "notifications": { "type": "boolean" }, "time_zone": { "type": "string" }, "statuses_count": { "type": "integer" }, "status": { "properties": { "coordinates": { "type": "string" }, "created_at": { "type": "string" }, "favorited": { "type": "boolean" }, "truncated": { "type": "boolean" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "text": { "type": "string" }, "contributors": { "type": "string" }, "retweet_count": { "type": "integer" }, "id": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "integer" }, "place": { "type": "string" }, "source": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "in_reply_to_status_id": { "type": "integer" } }, "type": "object" }, "profile_background_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /users/contributors{mediaTypeExtension}
GET

#### users contributors{mediaTypeExtension}

GET
/users/contributors{mediaTypeExtension}
Description
Returns a collection of users who can contribute to the specified account.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- user_id (integer )
  The ID of the user for whom to return results for.
- screen_name (string )
  The screen name of the user for whom to return results for.
- skip_status (string )
  When set to either true, t or 1 statuses will not be included in the returned user objects.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "profile_sidebar_fill_color": "F8FCF2", "profile_sidebar_border_color": "547980", "profile_background_tile": true, "name": "Ryan Sarver", "profile_image_url": "http://a0.twimg.com/profile_images/1777569006/image1327396628_normal.png", "created_at": "Mon Feb 26 18:05:55 +0000 2007", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "547980", "is_translator": false, "id_str": "795649", "default_profile": false, "contributors_enabled": true, "favourites_count": 3162, "url": null, "profile_image_url_https": "https://si0.twimg.com/profile_images/1777569006/image1327396628_normal.png", "utc_offset": -28800, "id": 795649, "profile_use_background_image": true, "listed_count": 1586, "profile_text_color": "594F4F", "lang": "en", "followers_count": 276334, "protected": false, "notifications": true, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/113854313/xa60e82408188860c483d73444d53e21.png", "profile_background_color": "45ADA8", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Director, Platform at Twitter. Detroit and Boston export. Foodie and over-the-hill hockey player. @devon's lesser half", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/113854313/xa60e82408188860c483d73444d53e21.png", "status": { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Sat Aug 25 19:33:11 +0000 2012", "retweeted_status": { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Sat Aug 25 19:20:36 +0000 2012", "id_str": "239442171466493953", "entities": { "urls": [ { "expanded_url": "http://nbcnews.to/NtkRTJ", "url": "http://t.co/f8ivBrVd", "indices": [ 102, 122 ], "display_url": "nbcnews.to/NtkRTJ" } ], "hashtags": [], "user_mentions": [] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "Neil Armstrong has died at the age of 82 from complications from heart operations he had 3 weeks ago. http://t.co/f8ivBrVd", "retweet_count": 112, "in_reply_to_status_id_str": null, "id": 239442171466493950, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "in_reply_to_screen_name": null, "source": "web", "in_reply_to_status_id": null }, "id_str": "239445335481647105", "entities": { "urls": [ { "expanded_url": "http://nbcnews.to/NtkRTJ", "url": "http://t.co/f8ivBrVd", "indices": [ 115, 135 ], "display_url": "nbcnews.to/NtkRTJ" } ], "hashtags": [], "user_mentions": [ { "name": "NBC News", "id_str": "14173315", "id": 14173315, "indices": [ 3, 11 ], "screen_name": "NBCNews" } ] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "RT @NBCNews: Neil Armstrong has died at the age of 82 from complications from heart operations he had 3 weeks ago. http://t.co/f8ivBrVd", "retweet_count": 112, "in_reply_to_status_id_str": null, "id": 239445335481647100, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "in_reply_to_screen_name": null, "source": "<a href=\"http://twitter.com\" rel=\"nofollow\">Twitter for iPhone</a>", "in_reply_to_status_id": null }, "statuses_count": 13728, "friends_count": 1780, "following": true, "show_all_inline_media": true, "screen_name": "rsarver" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "is_translator": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "description": { "type": "string" }, "profile_background_color": { "type": "string" }, "verified": { "type": "boolean" }, "notifications": { "type": "boolean" }, "time_zone": { "type": "string" }, "statuses_count": { "type": "integer" }, "status": { "properties": { "coordinates": { "type": "string" }, "created_at": { "type": "string" }, "favorited": { "type": "boolean" }, "truncated": { "type": "boolean" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "text": { "type": "string" }, "contributors": { "type": "string" }, "retweet_count": { "type": "integer" }, "id": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "integer" }, "place": { "type": "string" }, "source": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "in_reply_to_status_id": { "type": "integer" } }, "type": "object" }, "profile_background_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /users/profile_banner{mediaTypeExtension}
GET

#### users profile_banner{mediaTypeExtension}

GET
/users/profile_banner{mediaTypeExtension}
Description
Returns a map of the available size variations of the specified user's profile banner. If the user has not uploaded a profile banner, a HTTP 404 will be served instead. This method can be used instead of string manipulation on the profile_banner_url returned in user objects as described in User Profile Images and Banners. The profile banner data available at each size variant's URL is in PNG format.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- user_id (integer )
  The ID of the user for whom to return results for.
- screen_name (string )
  The screen name of the user for whom to return results for.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "sizes": { "ipad": { "w": 626, "url": "https://si0.twimg.com/profile_banners/6253282/1347394302/ipad", "h": 313 }, "mobile_retina": { "w": 640, "url": "https://si0.twimg.com/profile_banners/6253282/1347394302/mobile_retina", "h": 320 }, "mobile": { "w": 320, "url": "https://si0.twimg.com/profile_banners/6253282/1347394302/mobile", "h": 160 }, "web_retina": { "w": 1040, "url": "https://si0.twimg.com/profile_banners/6253282/1347394302/web_retina", "h": 520 }, "ipad_retina": { "w": 1252, "url": "https://si0.twimg.com/profile_banners/6253282/1347394302/ipad_retina", "h": 626 }, "web": { "w": 520, "url": "https://si0.twimg.com/profile_banners/6253282/1347394302/web", "h": 260 } } }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "sizes": { "ipad": { "properties": { "w": { "type": "integer" }, "url": { "type": "string" }, "h": { "type": "integer" } }, "type": "object" }, "mobile_retina": { "properties": { "w": { "type": "integer" }, "url": { "type": "string" }, "h": { "type": "integer" } }, "type": "object" }, "mobile": { "properties": { "w": { "type": "integer" }, "url": { "type": "string" }, "h": { "type": "integer" } }, "type": "object" }, "web_retina": { "properties": { "w": { "type": "integer" }, "url": { "type": "string" }, "h": { "type": "integer" } }, "type": "object" }, "ipad_retina": { "properties": { "w": { "type": "integer" }, "url": { "type": "string" }, "h": { "type": "integer" } }, "type": "object" }, "web": { "properties": { "w": { "type": "integer" }, "url": { "type": "string" }, "h": { "type": "integer" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /users/suggestions{mediaTypeExtension}
GET

#### users suggestions{mediaTypeExtension}

GET
/users/suggestions{mediaTypeExtension}
Description
Access to Twitter's suggested user list. This returns the list of suggested user categories. The category can be used in GET users/suggestions/{slug}.json to get the users in that category.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- lang (string )
  Restricts the suggested categories to the requested language. The language must be specified by the appropriate two letter ISO 639-1 representation. Currently supported languages are provided by the GET help/languages API request. Unsupported language codes will receive English (en) results. If you use lang in this request, ensure you also include it when requesting the GET users/suggestions/{slug}.json list.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "name": "Art & Design", "slug": "art-design", "size": 20 }, { "name": "Billboard Music Awards", "slug": "billboard-music-awards", "size": 20 }, { "name": "Books", "slug": "books", "size": 20 }, { "name": "Business", "slug": "business", "size": 20 }, { "name": "CMT Awards", "slug": "cmt-awards", "size": 20 }, { "name": "Charity", "slug": "charity", "size": 20 }, { "name": "Entertainment", "slug": "entertainment", "size": 20 }, { "name": "Faith and Religion", "slug": "faith-and-religion", "size": 20 }, { "name": "Family", "slug": "family", "size": 20 }, { "name": "Fashion", "slug": "fashion", "size": 20 }, { "name": "Food & Drink", "slug": "food-drink", "size": 20 }, { "name": "Funny", "slug": "funny", "size": 20 }, { "name": "Government", "slug": "government", "size": 20 }, { "name": "Health", "slug": "health", "size": 20 }, { "name": "MLB", "slug": "mlb", "size": 20 }, { "name": "MTV Movie Awards", "slug": "mtv-movie-awards", "size": 20 }, { "name": "Music", "slug": "music", "size": 20 }, { "name": "NASCAR", "slug": "nascar", "size": 20 }, { "name": "NBA", "slug": "nba", "size": 20 }, { "name": "NHL", "slug": "nhl", "size": 20 }, { "name": "News", "slug": "news", "size": 20 }, { "name": "PGA", "slug": "pga", "size": 20 }, { "name": "Science", "slug": "science", "size": 20 }, { "name": "Sports", "slug": "sports", "size": 20 }, { "name": "Staff Picks", "slug": "staff-picks", "size": 20 }, { "name": "Technology", "slug": "technology", "size": 20 }, { "name": "Television", "slug": "television", "size": 20 }, { "name": "Travel", "slug": "travel", "size": 20 }, { "name": "Twitter", "slug": "twitter", "size": 20 }, { "name": "US Election 2012", "slug": "us-election-2012", "size": 20 } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "name": { "type": "string" }, "slug": { "type": "string" }, "size": { "type": "integer" } }, "type": "object" } }, "type": "array" } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /users/suggestions{mediaTypeExtension}/{slug}{mediaTypeExtension}
GET

#### users suggestions{mediaTypeExtension} {slug}{mediaTypeExtension}

GET
/users/suggestions{mediaTypeExtension}/{slug}{mediaTypeExtension}
Description
Access the users in a given category of the Twitter suggested user list. It is recommended that applications cache this data for no more than one hour.

#### Request

##### Uri Parameters

- slug (string )
  The short name of list or a category
- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- lang (string )
  Restricts the suggested categories to the requested language. The language must be specified by the appropriate two letter ISO 639-1 representation. Currently supported languages are provided by the GET help/languages API request. Unsupported language codes will receive English (en) results. If you use lang in this request, ensure you also include it when requesting the GET users/suggestions/:slug list.

- #### Response

- ##### Http Status code
  200

- Content-Type: application/json

- ###### Example

  { "name": "Twitter", "slug": "twitter", "size": 20, "users": [ { "name": "Twitter Sverige", "profile_sidebar_border_color": "C0DEED", "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": false, "created_at": "Mon Oct 31 23:10:57 +0000 2011", "profile_image_url": "http://a0.twimg.com/profile_images/2284174853/63g4ld4sm6yh4sssy7wy_normal.png", "location": "Sweden", "profile_link_color": "0084B4", "follow_request_sent": false, "is_translator": false, "id_str": "402357141", "default_profile": true, "url": "https://twitter.com/about/translation", "favourites_count": 0, "contributors_enabled": true, "utc_offset": 3600, "id": 402357141, "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174853/63g4ld4sm6yh4sssy7wy_normal.png", "listed_count": 43, "profile_use_background_image": true, "profile_text_color": "333333", "protected": false, "lang": "sv", "followers_count": 55446, "geo_enabled": false, "time_zone": "Stockholm", "notifications": false, "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "profile_background_color": "C0DEED", "description": "Community-konto för Twitter i Sverige. Vi håller er uppdaterade kring vad som händer på Twitter i Sverige.", "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "friends_count": 260, "statuses_count": 62, "default_profile_image": false, "show_all_inline_media": false, "screen_name": "twitter_se", "following": false }, { "name": "Twitter Suomi", "profile_sidebar_border_color": "C0DEED", "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": false, "created_at": "Mon Oct 31 23:05:34 +0000 2011", "profile_image_url": "http://a0.twimg.com/profile_images/2284174783/cwp44h4tg1mkl90cta0p_normal.png", "location": "Finland", "profile_link_color": "0084B4", "follow_request_sent": false, "is_translator": false, "id_str": "402354593", "default_profile": true, "url": "https://twitter.com/about/translation", "favourites_count": 5, "contributors_enabled": true, "utc_offset": 7200, "id": 402354593, "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174783/cwp44h4tg1mkl90cta0p_normal.png", "listed_count": 49, "profile_use_background_image": true, "profile_text_color": "333333", "protected": false, "lang": "fi", "followers_count": 64440, "geo_enabled": false, "time_zone": "Helsinki", "notifications": false, "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "profile_background_color": "C0DEED", "description": "Twitterin suomalainen yhteisötili. Ylläpitäjinä käännösmoderaattorit @Zedinc, @SuihinOkko, @Delzun ja @DiamonDie.", "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "friends_count": 31, "statuses_count": 83, "default_profile_image": false, "show_all_inline_media": false, "screen_name": "twitter_fi", "following": false }, { "name": "Twitter Government", "profile_sidebar_border_color": "C0DEED", "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": false, "created_at": "Sat Dec 04 23:27:01 +0000 2010", "profile_image_url": "http://a0.twimg.com/profile_images/2284291316/xu1u3i11ugj03en53ujr_normal.png", "location": "Washington, DC", "profile_link_color": "0084B4", "follow_request_sent": false, "is_translator": false, "id_str": "222953824", "default_profile": false, "url": "http://twitter.com", "favourites_count": 6, "contributors_enabled": true, "utc_offset": -18000, "id": 222953824, "profile_image_url_https": "https://si0.twimg.com/profile_images/2284291316/xu1u3i11ugj03en53ujr_normal.png", "listed_count": 888, "profile_use_background_image": true, "profile_text_color": "333333", "protected": false, "lang": "en", "followers_count": 149418, "geo_enabled": true, "time_zone": "Eastern Time (US & Canada)", "notifications": false, "verified": true, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/378138859/townhallbg.jpg", "profile_background_color": "C0DEED", "description": "Updates from the Twitter Government & Politics team, tracking creative & effective uses of Twitter for civic engagement. RTs & examples≠political endorsements.", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/378138859/townhallbg.jpg", "friends_count": 0, "statuses_count": 338, "default_profile_image": false, "show_all_inline_media": false, "screen_name": "gov", "following": true } ] }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "name": { "type": "string" }, "slug": { "type": "string" }, "size": { "type": "integer" }, "users": { "0": { "properties": { "name": { "type": "string" }, "profile_sidebar_border_color": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "created_at": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "profile_link_color": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "default_profile": { "type": "boolean" }, "url": { "type": "string" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_image_url_https": { "type": "string" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "protected": { "type": "boolean" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "geo_enabled": { "type": "boolean" }, "time_zone": { "type": "string" }, "notifications": { "type": "boolean" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "profile_background_color": { "type": "string" }, "description": { "type": "string" }, "profile_background_image_url": { "type": "string" }, "friends_count": { "type": "integer" }, "statuses_count": { "type": "integer" }, "default_profile_image": { "type": "boolean" }, "show_all_inline_media": { "type": "boolean" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" } }, "type": "object" } }, "type": "array" } }

URl: /users/suggestions{mediaTypeExtension}/{slug}{mediaTypeExtension}/members{mediaTypeExtension}
GET

#### users suggestions{mediaTypeExtension} {slug}{mediaTypeExtension} members{mediaTypeExtension}

GET
/users/suggestions{mediaTypeExtension}/{slug}{mediaTypeExtension}/members{mediaTypeExtension}
Description
Access the users in a given category of the Twitter suggested user list and return their most recent status if they are not a protected user.

#### Request

##### Uri Parameters

- slug (string )
  The short name of list or a category
- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- #### Response

- ##### Http Status code
  200

- Content-Type: application/json

- ###### Example

  { "profile_sidebar_fill_color": "F8FCF2", "profile_sidebar_border_color": "547980", "profile_background_tile": true, "name": "Ryan Sarver", "profile_image_url": "http://a0.twimg.com/profile_images/1777569006/image1327396628_normal.png", "created_at": "Mon Feb 26 18:05:55 +0000 2007", "location": "San Francisco, CA", "follow_request_sent": false, "profile_link_color": "547980", "is_translator": false, "id_str": "795649", "default_profile": false, "contributors_enabled": true, "favourites_count": 3162, "url": null, "profile_image_url_https": "https://si0.twimg.com/profile_images/1777569006/image1327396628_normal.png", "utc_offset": -28800, "id": 795649, "profile_use_background_image": true, "listed_count": 1586, "profile_text_color": "594F4F", "lang": "en", "followers_count": 276334, "protected": false, "notifications": true, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/113854313/xa60e82408188860c483d73444d53e21.png", "profile_background_color": "45ADA8", "verified": false, "geo_enabled": true, "time_zone": "Pacific Time (US & Canada)", "description": "Director, Platform at Twitter. Detroit and Boston export. Foodie and over-the-hill hockey player. @devon's lesser half", "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/113854313/xa60e82408188860c483d73444d53e21.png", "status": { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Sat Aug 25 19:33:11 +0000 2012", "retweeted_status": { "coordinates": null, "favorited": false, "truncated": false, "created_at": "Sat Aug 25 19:20:36 +0000 2012", "id_str": "239442171466493953", "entities": { "urls": [ { "expanded_url": "http://nbcnews.to/NtkRTJ", "url": "http://t.co/f8ivBrVd", "indices": [ 102, 122 ], "display_url": "nbcnews.to/NtkRTJ" } ], "hashtags": [], "user_mentions": [] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "Neil Armstrong has died at the age of 82 from complications from heart operations he had 3 weeks ago. http://t.co/f8ivBrVd", "retweet_count": 112, "in_reply_to_status_id_str": null, "id": 239442171466493950, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "in_reply_to_screen_name": null, "source": "web", "in_reply_to_status_id": null }, "id_str": "239445335481647105", "entities": { "urls": [ { "expanded_url": "http://nbcnews.to/NtkRTJ", "url": "http://t.co/f8ivBrVd", "indices": [ 115, 135 ], "display_url": "nbcnews.to/NtkRTJ" } ], "hashtags": [], "user_mentions": [ { "name": "NBC News", "id_str": "14173315", "id": 14173315, "indices": [ 3, 11 ], "screen_name": "NBCNews" } ] }, "in_reply_to_user_id_str": null, "contributors": null, "text": "RT @NBCNews: Neil Armstrong has died at the age of 82 from complications from heart operations he had 3 weeks ago. http://t.co/f8ivBrVd", "retweet_count": 112, "in_reply_to_status_id_str": null, "id": 239445335481647100, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "in_reply_to_screen_name": null, "source": "<a href=\"http://twitter.com\" rel=\"nofollow\">Twitter for iPhone</a>", "in_reply_to_status_id": null }, "statuses_count": 13728, "friends_count": 1780, "following": true, "show_all_inline_media": true, "screen_name": "rsarver" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "is_translator": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "description": { "type": "string" }, "profile_background_color": { "type": "string" }, "verified": { "type": "boolean" }, "notifications": { "type": "boolean" }, "time_zone": { "type": "string" }, "statuses_count": { "type": "integer" }, "status": { "properties": { "coordinates": { "type": "string" }, "created_at": { "type": "string" }, "favorited": { "type": "boolean" }, "truncated": { "type": "boolean" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "text": { "type": "string" }, "contributors": { "type": "string" }, "retweet_count": { "type": "integer" }, "id": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "integer" }, "place": { "type": "string" }, "source": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "in_reply_to_status_id": { "type": "integer" } }, "type": "object" }, "profile_background_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" } } } }

URl: /users/report_spam{mediaTypeExtension}
POST

#### users report_spam{mediaTypeExtension}

POST
/users/report_spam{mediaTypeExtension}
Description
Report the specified user as a spam account to Twitter. Additionally performs the equivalent of POST blocks/create on behalf of the authenticated user. One of parameters must be provided.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "name": "Twitter API", "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": false, "profile_sidebar_border_color": "C0DEED", "profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "location": "San Francisco, CA", "created_at": "Wed May 23 06:01:13 +0000 2007", "follow_request_sent": false, "id_str": "6253282", "profile_link_color": "0084B4", "is_translator": false, "default_profile": true, "favourites_count": 24, "contributors_enabled": true, "url": "http://dev.twitter.com", "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "utc_offset": -28800, "id": 6253282, "profile_use_background_image": true, "listed_count": 10713, "profile_text_color": "333333", "lang": "en", "followers_count": 1198334, "protected": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "geo_enabled": true, "description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.", "profile_background_color": "C0DEED", "verified": true, "notifications": false, "time_zone": "Pacific Time (US & Canada)", "statuses_count": 3331, "status": { "coordinates": null, "created_at": "Fri Aug 24 16:15:49 +0000 2012", "favorited": false, "truncated": false, "id_str": "239033279343382529", "in_reply_to_user_id_str": "134727529", "text": "@gregclermont no, there is not. ^TS", "contributors": null, "retweet_count": 0, "id": 239033279343382529, "in_reply_to_status_id_str": "238933943146131456", "geo": null, "retweeted": false, "in_reply_to_user_id": 134727529, "place": null, "source": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>", "in_reply_to_screen_name": "gregclermont", "in_reply_to_status_id": 238933943146131456 }, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "default_profile_image": false, "friends_count": 31, "screen_name": "twitterapi", "following": true, "show_all_inline_media": false }, { "name": "Twitter", "profile_sidebar_fill_color": "F6F6F6", "profile_background_tile": true, "profile_sidebar_border_color": "EEEEEE", "profile_image_url": "http://a0.twimg.com/profile_images/2284174758/v65oai7fxn47qv9nectx_normal.png", "location": "San Francisco, CA", "created_at": "Tue Feb 20 14:35:54 +0000 2007", "follow_request_sent": false, "id_str": "783214", "profile_link_color": "038543", "is_translator": false, "default_profile": false, "favourites_count": 17, "contributors_enabled": true, "url": "http://blog.twitter.com/", "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174758/v65oai7fxn47qv9nectx_normal.png", "utc_offset": -28800, "id": 783214, "profile_banner_url": "https://si0.twimg.com/brand_banners/twitter/1323368512/live", "profile_use_background_image": true, "listed_count": 72534, "profile_text_color": "333333", "lang": "en", "followers_count": 12788713, "protected": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/378245879/Twitter_1544x2000.png", "geo_enabled": true, "description": "Always wondering what's happening. ", "profile_background_color": "ACDED6", "verified": true, "notifications": false, "time_zone": "Pacific Time (US & Canada)", "statuses_count": 1379, "status": { "coordinates": null, "created_at": "Tue Aug 21 19:04:00 +0000 2012", "favorited": false, "truncated": false, "id_str": "237988442338897920", "retweeted_status": { "coordinates": null, "created_at": "Tue Aug 21 18:51:44 +0000 2012", "favorited": false, "truncated": false, "id_str": "237985351858278400", "in_reply_to_user_id_str": null, "text": "Arijit Guha fought for insurance coverage, and won.\n http://t.co/ZvQ6fU2O #twitterstories http://t.co/bVYPNnV7", "contributors": [ 16896060 ], "retweet_count": 118, "id": 237985351858278400, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "source": "web", "in_reply_to_screen_name": null, "in_reply_to_status_id": null }, "in_reply_to_user_id_str": null, "text": "RT @TwitterStories: Arijit Guha fought for insurance coverage, and won.\n http://t.co/ZvQ6fU2O #twitterstories http://t.co/bVYPNnV7", "contributors": null, "retweet_count": 118, "id": 237988442338897920, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "place": null, "source": "web", "in_reply_to_screen_name": null, "in_reply_to_status_id": null }, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/378245879/Twitter_1544x2000.png", "default_profile_image": false, "friends_count": 1195, "screen_name": "twitter", "following": true, "show_all_inline_media": true } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "is_translator": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "description": { "type": "string" }, "profile_background_color": { "type": "string" }, "verified": { "type": "boolean" }, "notifications": { "type": "boolean" }, "time_zone": { "type": "string" }, "statuses_count": { "type": "integer" }, "status": { "properties": { "coordinates": { "type": "string" }, "created_at": { "type": "string" }, "favorited": { "type": "boolean" }, "truncated": { "type": "boolean" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "text": { "type": "string" }, "contributors": { "type": "string" }, "retweet_count": { "type": "integer" }, "id": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "integer" }, "place": { "type": "string" }, "source": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "in_reply_to_status_id": { "type": "integer" } }, "type": "object" }, "profile_background_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /favorites

#### favorites

URl: /favorites/list{mediaTypeExtension}
GET

#### favorites list{mediaTypeExtension}

GET
/favorites/list{mediaTypeExtension}
Description
Returns the 20 most recent Tweets favorited by the authenticating or specified user. If you do not provide either a user_id or screen_name to this method, it will assume you are requesting on behalf of the authenticating user. Specify one or the other for best results.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- user_id (integer )
  The ID of the user for whom to return results for.
- screen_name (string )
  The screen name of the user for whom to return results for.
- count (integer )
  Specifies the number of records to retrieve. Must be less than or equal to 200. Defaults to 20.
- since_id (integer )
  Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occured since the since_id, the since_id will be forced to the oldest ID available.
- max_id (integer )
  Returns results with an ID less than (that is, older than) or equal to the specified ID.
- include_entities (string )
  The entities node will be omitted when set to false.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "coordinates": null, "truncated": false, "favorited": true, "created_at": "Tue Sep 04 15:55:52 +0000 2012", "id_str": "243014525132091393", "in_reply_to_user_id_str": null, "entities": { "urls": [ ], "hashtags": [ ], "user_mentions": [ ] }, "text": "Note to self: don't die during off-peak hours on a holiday weekend.", "contributors": null, "id": 243014525132091393, "retweet_count": 0, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "in_reply_to_screen_name": null, "source": "web", "user": { "profile_sidebar_fill_color": "252429", "profile_background_tile": true, "profile_sidebar_border_color": "181A1E", "name": "Sean Cook", "profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "location": "San Francisco", "created_at": "Sat May 09 17:58:22 +0000 2009", "follow_request_sent": false, "is_translator": false, "id_str": "38895958", "profile_link_color": "2FC2EF", "entities": { "description": { "urls": [ ] } }, "favourites_count": 594, "url": null, "default_profile": false, "contributors_enabled": true, "profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "utc_offset": -28800, "id": 38895958, "listed_count": 191, "profile_use_background_image": true, "followers_count": 10659, "protected": false, "profile_text_color": "666666", "lang": "en", "profile_background_color": "1A1B1F", "time_zone": "Pacific Time (US & Canada)", "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png", "description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ", "geo_enabled": true, "notifications": false, "default_profile_image": false, "friends_count": 1186, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png", "statuses_count": 2629, "following": true, "screen_name": "theSeanCook", "show_all_inline_media": true }, "place": { "name": "San Francisco", "country_code": "US", "country": "United States", "attributes": { }, "url": "http://api.twitter.com/1/geo/id/5a110d312052166f.json", "id": "5a110d312052166f", "bounding_box": { "coordinates": [ [ [ -122.51368188, 37.70813196 ], [ -122.35845384, 37.70813196 ], [ -122.35845384, 37.83245301 ], [ -122.51368188, 37.83245301 ] ] ], "type": "Polygon" }, "full_name": "San Francisco, CA", "place_type": "city" }, "in_reply_to_status_id": null }, { "coordinates": null, "truncated": false, "favorited": true, "created_at": "Tue Sep 04 00:17:11 +0000 2012", "id_str": "242778296117514240", "in_reply_to_user_id_str": null, "entities": { "urls": [ ], "hashtags": [ ], "user_mentions": [ ] }, "text": "TWIT NPC. TWIT DUNGEONMASTER.", "contributors": null, "id": 242778296117514240, "retweet_count": 1, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "in_reply_to_screen_name": null, "source": "<a href=\"http://twitter.com/download/android\" rel=\"nofollow\">Twitter for Android</a>", "user": { "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": false, "profile_sidebar_border_color": "C0DEED", "name": "REGIS", "profile_image_url": "http://a0.twimg.com/profile_images/1812284389/allseeingeye_normal.jpg", "location": "", "created_at": "Wed May 07 19:27:16 +0000 2008", "follow_request_sent": false, "is_translator": false, "id_str": "14690653", "profile_link_color": "009999", "entities": { "description": { "urls": [ ] } }, "favourites_count": 46407, "url": null, "default_profile": false, "contributors_enabled": false, "profile_image_url_https": "https://si0.twimg.com/profile_images/1812284389/allseeingeye_normal.jpg", "utc_offset": -25200, "id": 14690653, "listed_count": 194, "profile_use_background_image": true, "followers_count": 4198, "protected": false, "profile_text_color": "333333", "lang": "en", "profile_background_color": "131516", "time_zone": "Mountain Time (US & Canada)", "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/530267284/11111.JPG", "description": "Everything I tweet is or shall be.", "geo_enabled": true, "notifications": false, "default_profile_image": false, "friends_count": 200, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/530267284/11111.JPG", "statuses_count": 43345, "following": true, "screen_name": "regisl", "show_all_inline_media": false }, "place": null, "in_reply_to_status_id": null } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /favorites/destroy{mediaTypeExtension}
POST

#### favorites destroy{mediaTypeExtension}

POST
/favorites/destroy{mediaTypeExtension}
Description
Un-favorites the status specified in the ID parameter as the authenticating user. Returns the un-favorited status in the requested format when successful. This process invoked by this method is asynchronous. The immediately returned status may not indicate the resultant favorited status of the tweet. A 200 OK response from this method will indicate whether the intended action was successful or not.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "coordinates": null, "truncated": false, "favorited": true, "created_at": "Tue Sep 04 15:55:52 +0000 2012", "id_str": "243014525132091393", "in_reply_to_user_id_str": null, "entities": { "urls": [ ], "hashtags": [ ], "user_mentions": [ ] }, "text": "Note to self: don't die during off-peak hours on a holiday weekend.", "contributors": null, "id": 243014525132091393, "retweet_count": 0, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "in_reply_to_screen_name": null, "source": "web", "user": { "profile_sidebar_fill_color": "252429", "profile_background_tile": true, "profile_sidebar_border_color": "181A1E", "name": "Sean Cook", "profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "location": "San Francisco", "created_at": "Sat May 09 17:58:22 +0000 2009", "follow_request_sent": false, "is_translator": false, "id_str": "38895958", "profile_link_color": "2FC2EF", "entities": { "description": { "urls": [ ] } }, "favourites_count": 594, "url": null, "default_profile": false, "contributors_enabled": true, "profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "utc_offset": -28800, "id": 38895958, "listed_count": 191, "profile_use_background_image": true, "followers_count": 10659, "protected": false, "profile_text_color": "666666", "lang": "en", "profile_background_color": "1A1B1F", "time_zone": "Pacific Time (US & Canada)", "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png", "description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ", "geo_enabled": true, "notifications": false, "default_profile_image": false, "friends_count": 1186, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png", "statuses_count": 2629, "following": true, "screen_name": "theSeanCook", "show_all_inline_media": true }, "place": { "name": "San Francisco", "country_code": "US", "country": "United States", "attributes": { }, "url": "http://api.twitter.com/1/geo/id/5a110d312052166f.json", "id": "5a110d312052166f", "bounding_box": { "coordinates": [ [ [ -122.51368188, 37.70813196 ], [ -122.35845384, 37.70813196 ], [ -122.35845384, 37.83245301 ], [ -122.51368188, 37.83245301 ] ] ], "type": "Polygon" }, "full_name": "San Francisco, CA", "place_type": "city" }, "in_reply_to_status_id": null }, { "coordinates": null, "truncated": false, "favorited": true, "created_at": "Tue Sep 04 00:17:11 +0000 2012", "id_str": "242778296117514240", "in_reply_to_user_id_str": null, "entities": { "urls": [ ], "hashtags": [ ], "user_mentions": [ ] }, "text": "TWIT NPC. TWIT DUNGEONMASTER.", "contributors": null, "id": 242778296117514240, "retweet_count": 1, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "in_reply_to_screen_name": null, "source": "<a href=\"http://twitter.com/download/android\" rel=\"nofollow\">Twitter for Android</a>", "user": { "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": false, "profile_sidebar_border_color": "C0DEED", "name": "REGIS", "profile_image_url": "http://a0.twimg.com/profile_images/1812284389/allseeingeye_normal.jpg", "location": "", "created_at": "Wed May 07 19:27:16 +0000 2008", "follow_request_sent": false, "is_translator": false, "id_str": "14690653", "profile_link_color": "009999", "entities": { "description": { "urls": [ ] } }, "favourites_count": 46407, "url": null, "default_profile": false, "contributors_enabled": false, "profile_image_url_https": "https://si0.twimg.com/profile_images/1812284389/allseeingeye_normal.jpg", "utc_offset": -25200, "id": 14690653, "listed_count": 194, "profile_use_background_image": true, "followers_count": 4198, "protected": false, "profile_text_color": "333333", "lang": "en", "profile_background_color": "131516", "time_zone": "Mountain Time (US & Canada)", "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/530267284/11111.JPG", "description": "Everything I tweet is or shall be.", "geo_enabled": true, "notifications": false, "default_profile_image": false, "friends_count": 200, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/530267284/11111.JPG", "statuses_count": 43345, "following": true, "screen_name": "regisl", "show_all_inline_media": false }, "place": null, "in_reply_to_status_id": null } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /favorites/create{mediaTypeExtension}
POST

#### favorites create{mediaTypeExtension}

POST
/favorites/create{mediaTypeExtension}
Description
Favorites the status specified in the ID parameter as the authenticating user. Returns the favorite status when successful. This process invoked by this method is asynchronous. The immediately returned status may not indicate the resultant favorited status of the tweet. A 200 OK response from this method will indicate whether the intended action was successful or not.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "coordinates": null, "truncated": false, "favorited": true, "created_at": "Tue Sep 04 15:55:52 +0000 2012", "id_str": "243014525132091393", "in_reply_to_user_id_str": null, "entities": { "urls": [ ], "hashtags": [ ], "user_mentions": [ ] }, "text": "Note to self: don't die during off-peak hours on a holiday weekend.", "contributors": null, "id": 243014525132091393, "retweet_count": 0, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "in_reply_to_screen_name": null, "source": "web", "user": { "profile_sidebar_fill_color": "252429", "profile_background_tile": true, "profile_sidebar_border_color": "181A1E", "name": "Sean Cook", "profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "location": "San Francisco", "created_at": "Sat May 09 17:58:22 +0000 2009", "follow_request_sent": false, "is_translator": false, "id_str": "38895958", "profile_link_color": "2FC2EF", "entities": { "description": { "urls": [ ] } }, "favourites_count": 594, "url": null, "default_profile": false, "contributors_enabled": true, "profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", "utc_offset": -28800, "id": 38895958, "listed_count": 191, "profile_use_background_image": true, "followers_count": 10659, "protected": false, "profile_text_color": "666666", "lang": "en", "profile_background_color": "1A1B1F", "time_zone": "Pacific Time (US & Canada)", "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png", "description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ", "geo_enabled": true, "notifications": false, "default_profile_image": false, "friends_count": 1186, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png", "statuses_count": 2629, "following": true, "screen_name": "theSeanCook", "show_all_inline_media": true }, "place": { "name": "San Francisco", "country_code": "US", "country": "United States", "attributes": { }, "url": "http://api.twitter.com/1/geo/id/5a110d312052166f.json", "id": "5a110d312052166f", "bounding_box": { "coordinates": [ [ [ -122.51368188, 37.70813196 ], [ -122.35845384, 37.70813196 ], [ -122.35845384, 37.83245301 ], [ -122.51368188, 37.83245301 ] ] ], "type": "Polygon" }, "full_name": "San Francisco, CA", "place_type": "city" }, "in_reply_to_status_id": null }, { "coordinates": null, "truncated": false, "favorited": true, "created_at": "Tue Sep 04 00:17:11 +0000 2012", "id_str": "242778296117514240", "in_reply_to_user_id_str": null, "entities": { "urls": [ ], "hashtags": [ ], "user_mentions": [ ] }, "text": "TWIT NPC. TWIT DUNGEONMASTER.", "contributors": null, "id": 242778296117514240, "retweet_count": 1, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "in_reply_to_user_id": null, "in_reply_to_screen_name": null, "source": "<a href=\"http://twitter.com/download/android\" rel=\"nofollow\">Twitter for Android</a>", "user": { "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": false, "profile_sidebar_border_color": "C0DEED", "name": "REGIS", "profile_image_url": "http://a0.twimg.com/profile_images/1812284389/allseeingeye_normal.jpg", "location": "", "created_at": "Wed May 07 19:27:16 +0000 2008", "follow_request_sent": false, "is_translator": false, "id_str": "14690653", "profile_link_color": "009999", "entities": { "description": { "urls": [ ] } }, "favourites_count": 46407, "url": null, "default_profile": false, "contributors_enabled": false, "profile_image_url_https": "https://si0.twimg.com/profile_images/1812284389/allseeingeye_normal.jpg", "utc_offset": -25200, "id": 14690653, "listed_count": 194, "profile_use_background_image": true, "followers_count": 4198, "protected": false, "profile_text_color": "333333", "lang": "en", "profile_background_color": "131516", "time_zone": "Mountain Time (US & Canada)", "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/530267284/11111.JPG", "description": "Everything I tweet is or shall be.", "geo_enabled": true, "notifications": false, "default_profile_image": false, "friends_count": 200, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/530267284/11111.JPG", "statuses_count": 43345, "following": true, "screen_name": "regisl", "show_all_inline_media": false }, "place": null, "in_reply_to_status_id": null } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists

#### lists

URl: /lists/list{mediaTypeExtension}
GET

#### lists list{mediaTypeExtension}

GET
/lists/list{mediaTypeExtension}
Description
Returns all lists the authenticating or specified user subscribes to, including their own. The user is specified using the user_id or screen_name parameters. If no user is given, the authenticating user is used. This method used to be GET lists in version 1.0 of the API and has been renamed for consistency with other call. A maximum of 100 results will be returned by this call. Subscribed lists are returned first, followed by owned lists. This means that if a user subscribes to 90 lists and owns 20 lists, this method returns 90 subscriptions and 10 owned lists. The reverse method returns owned lists first, so with reverse=true, 20 owned lists and 80 subscriptions would be returned. If your goal is to obtain every list a user owns or subscribes to, use GET lists/ownerships and/or GET lists/subscriptions instead.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- user_id (integer )
  The ID of the user for whom to return results for. Helpful for disambiguating when a valid user ID is also a valid screen name.
- screen_name (string )
  The screen name of the user for whom to return results for. Helpful for disambiguating when a valid screen name is also a user ID.
- reverse (string )
  Set this to true if you would like owned lists to be returned first. See description above for information on how this parameter works.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "slug": "meetup-20100301", "name": "meetup-20100301", "created_at": "Sat Feb 27 21:39:24 +0000 2010", "uri": "/twitterapi/meetup-20100301", "subscriber_count": 147, "id_str": "8044403", "member_count": 116, "mode": "public", "id": 8044403, "full_name": "@twitterapi/meetup-20100301", "description": "Guests attending the Twitter meetup on 1 March 2010 at the @twoffice", "user": { "profile_background_tile": true, "profile_sidebar_border_color": "C0DEED", "name": "Twitter API", "profile_sidebar_fill_color": "DDEEF6", "location": "San Francisco, CA", "created_at": "Wed May 23 06:01:13 +0000 2007", "profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "is_translator": false, "id_str": "6253282", "profile_link_color": "0084B4", "follow_request_sent": false, "favourites_count": 25, "contributors_enabled": true, "url": "http://dev.twitter.com", "default_profile": false, "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "utc_offset": -28800, "profile_banner_url": "https://si0.twimg.com/profile_banners/6253282/1347394302", "id": 6253282, "profile_use_background_image": true, "listed_count": 11201, "profile_text_color": "333333", "protected": false, "lang": "en", "followers_count": 1444739, "description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.", "notifications": false, "geo_enabled": true, "verified": true, "time_zone": "Pacific Time (US & Canada)", "profile_background_color": "C0DEED", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png", "statuses_count": 3367, "friends_count": 33, "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png", "following": true, "screen_name": "twitterapi" }, "following": false }, { "slug": "team", "name": "team", "created_at": "Wed Nov 04 01:24:28 +0000 2009", "uri": "/twitterapi/team", "subscriber_count": 277, "id_str": "2031945", "member_count": 20, "mode": "public", "id": 2031945, "full_name": "@twitterapi/team", "description": "", "user": { "profile_background_tile": true, "profile_sidebar_border_color": "C0DEED", "name": "Twitter API", "profile_sidebar_fill_color": "DDEEF6", "location": "San Francisco, CA", "created_at": "Wed May 23 06:01:13 +0000 2007", "profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "is_translator": false, "id_str": "6253282", "profile_link_color": "0084B4", "follow_request_sent": false, "favourites_count": 25, "contributors_enabled": true, "url": "http://dev.twitter.com", "default_profile": false, "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "utc_offset": -28800, "profile_banner_url": "https://si0.twimg.com/profile_banners/6253282/1347394302", "id": 6253282, "profile_use_background_image": true, "listed_count": 11201, "profile_text_color": "333333", "protected": false, "lang": "en", "followers_count": 1444739, "description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.", "notifications": false, "geo_enabled": true, "verified": true, "time_zone": "Pacific Time (US & Canada)", "profile_background_color": "C0DEED", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png", "statuses_count": 3367, "friends_count": 33, "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png", "following": true, "screen_name": "twitterapi" }, "following": true } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "slug": { "type": "string" }, "name": { "type": "string" }, "created_at": { "type": "string" }, "uri": { "type": "string" }, "subscriber_count": { "type": "integer" }, "id_str": { "type": "string" }, "member_count": { "type": "integer" }, "mode": { "type": "string" }, "id": { "type": "integer" }, "full_name": { "type": "string" }, "description": { "type": "string" }, "user": { "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "profile_image_url": { "type": "string" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "profile_banner_url": { "type": "string" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "protected": { "type": "boolean" }, "lang": "en", "followers_count": { "type": "integer" }, "description": { "type": "string" }, "notifications": { "type": "boolean" }, "geo_enabled": { "type": "boolean" }, "verified": { "type": "boolean" }, "time_zone": { "type": "string" }, "profile_background_color": { "type": "string" }, "profile_background_image_url_https": { "type": "string" }, "statuses_count": { "type": "integer" }, "friends_count": { "type": "integer" }, "default_profile_image": { "type": "boolean" }, "profile_background_image_url": { "type": "string" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" } }, "following": { "type": "boolean" } }, "type": "object" } }, "type": "array" } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/statuses{mediaTypeExtension}
GET

#### lists statuses{mediaTypeExtension}

GET
/lists/statuses{mediaTypeExtension}
Description
Returns a timeline of tweets authored by members of the specified list. Retweets are included by default. Use the include_rts=false parameter to omit retweets. Embedded Timelines is a great way to embed list timelines on your website.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- list_id (integer )
  The numerical id of the list.
- slug (string )
  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 (string )
  The screen name of the user who owns the list being requested by a slug.
- owner_id (integer )
  The user ID of the user who owns the list being requested by a slug.
- since_id (integer )
  Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occured since the since_id, the since_id will be forced to the oldest ID available.
- max_id (integer )
  Returns results with an ID less than (that is, older than) or equal to the specified ID.
- count (integer )
  Specifies the number of results to retrieve per "page."
- include_rts (string )
  When set to either true, t or 1, the list timeline will contain native retweets (if they exist) in addition to the standard stream of tweets. The output format of retweeted tweets is identical to the representation you see in home_timeline.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "coordinates": null, "created_at": "Mon Sep 10 14:04:58 +0000 2012", "truncated": false, "favorited": false, "id_str": "245160944223793152", "in_reply_to_user_id_str": null, "entities": { "urls": [ { "expanded_url": "http://bit.ly/MuCCDo", "url": "http://t.co/W2tON3OK", "indices": [ 41, 61 ], "display_url": "bit.ly/MuCCDo" } ], "hashtags": [ { "text": "TorontoFC", "indices": [ 87, 97 ] }, { "text": "MLS", "indices": [ 98, 102 ] } ], "user_mentions": [ { "name": "Team Up Foundation", "id_str": "210844741", "id": 210844741, "indices": [ 76, 86 ], "screen_name": "TeamUpFdn" } ] }, "text": "Create your own TFC ESQ by Movado Watch: http://t.co/W2tON3OK in support of @TeamUpFdn #TorontoFC #MLS", "contributors": null, "id": 245160944223793152, "retweet_count": 0, "in_reply_to_status_id_str": null, "geo": null, "retweeted": false, "possibly_sensitive": false, "in_reply_to_user_id": null, "in_reply_to_screen_name": null, "source": "<a href=\"http://www.tweetdeck.com\" rel=\"nofollow\">TweetDeck</a>", "user": { "profile_sidebar_fill_color": "EB1D31", "profile_background_tile": false, "profile_sidebar_border_color": "FFFFFF", "name": "Toronto FC", "profile_image_url": "http://a0.twimg.com/profile_images/1827235104/TorontoFC1_normal.jpg", "created_at": "Fri Sep 11 15:42:26 +0000 2009", "location": "Toronto, ON", "follow_request_sent": false, "is_translator": false, "id_str": "73412535", "profile_link_color": "000000", "entities": { "url": { "urls": [ { "expanded_url": null, "url": "http://www.torontofc.ca", "indices": [ 0, 23 ], "display_url": null } ] }, "description": { "urls": [ ] } }, "favourites_count": 2, "url": "http://www.torontofc.ca", "default_profile": false, "contributors_enabled": false, "profile_image_url_https": "https://si0.twimg.com/profile_images/1827235104/TorontoFC1_normal.jpg", "utc_offset": -18000, "id": 73412535, "listed_count": 1078, "profile_use_background_image": true, "followers_count": 28281, "protected": false, "profile_text_color": "000000", "lang": "en", "profile_background_color": "BC1228", "verified": true, "time_zone": "Eastern Time (US & Canada)", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/603424485/k9py0fm18qrjr8l22qlp.jpeg", "notifications": false, "description": "Official Toronto FC Twitter by @AsifinToronto & @JonSinden. Follow us for the latest club news, links, pics & videos. Join us during matches for #TFClive", "geo_enabled": false, "default_profile_image": false, "friends_count": 13947, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/603424485/k9py0fm18qrjr8l22qlp.jpeg", "statuses_count": 10774, "screen_name": "torontofc", "following": true, "show_all_inline_media": false }, "place": null, "in_reply_to_status_id": null } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "coordinates": { "properties": { "coordinates": { "0": { "type": "number" } }, "type": { "type": "string" } }, "type": "object" }, "truncated": { "type": "boolean" }, "favorited": { "type": "boolean" }, "created_at": { "type": "string" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "text": { "type": "string" }, "contributors": { "0": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" } } }, "type": "array", "id": { "type": "integer" }, "retweet_count": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "source": { "type": "string" }, "user": { "properties": { "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "favourites_count": { "type": "integer" }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "listed_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "profile_background_color": { "type": "string" }, "time_zone": { "type": "string" }, "verified": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "description": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "notifications": { "type": "boolean" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "profile_background_image_url": { "type": "string" }, "statuses_count": { "type": "integer" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" }, "place": { "name": { "type": "string" }, "country_code": { "type": "string" }, "country": { "type": "string" }, "attributes": { "properties": { "street_address": { "type": "string" }, "623:id": { "type": "string" }, "twitter": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "id": { "type": "string" }, "bounding_box": { "properties": { "coordinates": { "0": { "0": { "properties": { "_empty_": { "0": { "type": "number" } } }, "type": "object" } } }, "type": { "type": "string" } }, "type": "object" }, "full_name": { "type": "string" }, "place_type": { "type": "string" } }, "in_reply_to_status_id": { "type": "string" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/memberships{mediaTypeExtension}
GET

#### lists memberships{mediaTypeExtension}

GET
/lists/memberships{mediaTypeExtension}
Description
Returns the lists the specified user has been added to. If user_id or screen_name are not provided the memberships for the authenticating user are returned.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- user_id (integer )
  The ID of the user for whom to return results for. Helpful for disambiguating when a valid user ID is also a valid screen name.
- screen_name (string )
  The screen name of the user for whom to return results for. Helpful for disambiguating when a valid screen name is also a user ID.
- cursor (integer )
  Breaks the results into pages. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list. It is recommended to always use cursors when the method supports them. See Using cursors to navigate collections for more information.
- filter_to_owned_lists (string )
  When set to true, t or 1, will return just lists the authenticating user owns, and the user represented by user_id or screen_name is a member of.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "lists": [ { "name": "Digital Marketing", "slug": "digital-marketing", "uri": "/pointcg/digital-marketing", "id_str": "49260625", "subscriber_count": 1, "member_count": 46, "mode": "public", "id": 49260625, "full_name": "@pointcg/digital-marketing", "description": "", "user": { "profile_sidebar_border_color": "447DBC", "profile_background_tile": false, "profile_sidebar_fill_color": "447DBC", "name": "Chris Greco", "created_at": "Wed Feb 28 01:05:01 +0000 2007", "location": "", "profile_image_url": "http://a1.twimg.com/profile_images/1331628329/chris_2_normal.jpg", "follow_request_sent": false, "profile_link_color": "0000FF", "is_translator": false, "id_str": "799757", "default_profile": false, "favourites_count": 2, "contributors_enabled": false, "url": null, "id": 799757, "profile_image_url_https": "https://si0.twimg.com/profile_images/1331628329/chris_2_normal.jpg", "utc_offset": -18000, "profile_use_background_image": true, "listed_count": 4, "lang": "en", "followers_count": 66, "profile_text_color": "000000", "protected": false, "profile_background_color": "0F5B5F", "verified": false, "time_zone": "Eastern Time (US & Canada)", "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "description": "", "notifications": false, "geo_enabled": false, "statuses_count": 122, "default_profile_image": false, "friends_count": 80, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "following": false, "screen_name": "pointcg", "show_all_inline_media": false }, "following": false }, { "name": "vanessa williams", "slug": "vanessa-williams", "uri": "/Barbis_doll/vanessa-williams", "id_str": "49270287", "subscriber_count": 0, "member_count": 1, "mode": "public", "id": 49270287, "full_name": "@Barbis_doll/vanessa-williams", "description": "former ms. america, talented dancer, singer and actress", "user": { "profile_sidebar_border_color": "C0DEED", "name": "Debbie M.", "profile_background_tile": false, "profile_sidebar_fill_color": "DDEEF6", "location": null, "profile_image_url": "http://a3.twimg.com/sticky/default_profile_images/default_profile_4_normal.png", "created_at": "Tue Jun 28 00:50:43 +0000 2011", "is_translator": false, "profile_link_color": "0084B4", "id_str": "325263705", "follow_request_sent": null, "url": null, "favourites_count": 0, "contributors_enabled": false, "default_profile": true, "utc_offset": null, "id": 325263705, "profile_image_url_https": "https://si0.twimg.com/sticky/default_profile_images/default_profile_4_normal.png", "listed_count": 0, "profile_use_background_image": true, "protected": false, "followers_count": 2, "lang": "en", "profile_text_color": "333333", "time_zone": null, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "notifications": null, "geo_enabled": false, "description": null, "profile_background_color": "C0DEED", "verified": false, "default_profile_image": true, "friends_count": 11, "statuses_count": 6, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "following": null, "screen_name": "Barbis_doll", "show_all_inline_media": false }, "following": false } ], "previous_cursor_str": "0", "next_cursor": 1373407125131783200, "next_cursor_str": "1373407125131783107" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "slug": { "type": "string" }, "name": { "type": "string" }, "created_at": { "type": "string" }, "uri": { "type": "string" }, "subscriber_count": { "type": "integer" }, "id_str": { "type": "string" }, "member_count": { "type": "integer" }, "mode": { "type": "string" }, "id": { "type": "integer" }, "full_name": { "type": "string" }, "description": { "type": "string" }, "user": { "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "profile_image_url": { "type": "string" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "profile_banner_url": { "type": "string" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "protected": { "type": "boolean" }, "lang": "en", "followers_count": { "type": "integer" }, "description": { "type": "string" }, "notifications": { "type": "boolean" }, "geo_enabled": { "type": "boolean" }, "verified": { "type": "boolean" }, "time_zone": { "type": "string" }, "profile_background_color": { "type": "string" }, "profile_background_image_url_https": { "type": "string" }, "statuses_count": { "type": "integer" }, "friends_count": { "type": "integer" }, "default_profile_image": { "type": "boolean" }, "profile_background_image_url": { "type": "string" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" } }, "following": { "type": "boolean" } }, "type": "object" } }, "type": "array" } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/subscribers{mediaTypeExtension}
GET

#### lists subscribers{mediaTypeExtension}

GET
/lists/subscribers{mediaTypeExtension}
Description
Returns the subscribers of the specified list. Private list subscribers will only be shown if the authenticated user owns the specified list. Either a list_id or a slug is required. If providing a list_slug, an owner_screen_name or owner_id is also required.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- list_id (integer )
  The numerical id of the list.
- slug (string )
  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 (string )
  The screen name of the user who owns the list being requested by a slug.
- owner_id (integer )
  The user ID of the user who owns the list being requested by a slug.
- cursor (integer )
  Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
- skip_status (string )
  When set to either true, t or 1 statuses will not be included in the returned user objects.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "previous_cursor_str": "0", "next_cursor": 1357643166637635702, "users": [ { "profile_background_tile": false, "profile_sidebar_fill_color": "DDEEF6", "name": "Almissen665", "profile_sidebar_border_color": "C0DEED", "location": null, "profile_image_url": "http://a0.twimg.com/sticky/default_profile_images/default_profile_1_normal.png", "created_at": "Mon Jun 27 09:17:15 +0000 2011", "follow_request_sent": false, "is_translator": false, "profile_link_color": "0084B4", "id_str": "324841714", "url": null, "default_profile": true, "contributors_enabled": false, "favourites_count": 0, "id": 324841714, "utc_offset": null, "profile_image_url_https": "https://si0.twimg.com/sticky/default_profile_images/default_profile_1_normal.png", "profile_use_background_image": true, "listed_count": 0, "lang": "en", "profile_text_color": "333333", "followers_count": 6, "protected": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "notifications": false, "geo_enabled": false, "description": null, "profile_background_color": "C0DEED", "time_zone": null, "verified": false, "statuses_count": 1, "friends_count": 27, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "default_profile_image": true, "screen_name": "bonasser789", "following": false, "show_all_inline_media": false }, { "profile_sidebar_fill_color": "E6F6F9", "profile_sidebar_border_color": "DBE9ED", "name": "GR Syber-Space", "profile_background_tile": true, "location": "Grand Rapids, MI", "profile_image_url": "http://a2.twimg.com/profile_images/1322547748/images__97__normal.jpg", "created_at": "Thu Sep 30 23:05:38 +0000 2010", "profile_link_color": "CC3366", "id_str": "197218370", "follow_request_sent": false, "is_translator": false, "url": "http://www.wix.com/castlesportsgr/myj", "default_profile": false, "favourites_count": 2, "contributors_enabled": false, "id": 197218370, "utc_offset": -18000, "profile_image_url_https": "https://si0.twimg.com/profile_images/1322547748/images__97__normal.jpg", "profile_use_background_image": true, "listed_count": 268, "lang": "en", "profile_text_color": "333333", "followers_count": 2628, "protected": true, "notifications": false, "geo_enabled": true, "profile_background_color": "DBE9ED", "description": "Welcome to Teen Gossip 411. Celebrity Gossip, Teens fashion trends for the summer 2011, Hollywood Gossip, Hotest music, Teen Websites, and more.", "time_zone": "Quito", "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/237705957/images__97_.jpg", "default_profile_image": false, "friends_count": 2846, "profile_background_image_url": "http://a2.twimg.com/profile_background_images/237705957/images__97_.jpg", "statuses_count": 7463, "show_all_inline_media": true, "screen_name": "GRSYBERSPACE", "following": false } ], "next_cursor_str": "1357643166637635702" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "is_translator": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "description": { "type": "string" }, "profile_background_color": { "type": "string" }, "verified": { "type": "boolean" }, "notifications": { "type": "boolean" }, "time_zone": { "type": "string" }, "statuses_count": { "type": "integer" }, "status": { "properties": { "coordinates": { "type": "string" }, "created_at": { "type": "string" }, "favorited": { "type": "boolean" }, "truncated": { "type": "boolean" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "text": { "type": "string" }, "contributors": { "type": "string" }, "retweet_count": { "type": "integer" }, "id": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "integer" }, "place": { "type": "string" }, "source": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "in_reply_to_status_id": { "type": "integer" } }, "type": "object" }, "profile_background_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/subscribers{mediaTypeExtension}/create
POST

#### lists subscribers{mediaTypeExtension} create

POST
/lists/subscribers{mediaTypeExtension}/create
Description
Subscribes the authenticated user to the specified list. Either a list_id or a slug is required. If providing a list_slug, an owner_screen_name or owner_id is also required.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "previous_cursor_str": "0", "next_cursor": 1357643166637635702, "users": [ { "profile_background_tile": false, "profile_sidebar_fill_color": "DDEEF6", "name": "Almissen665", "profile_sidebar_border_color": "C0DEED", "location": null, "profile_image_url": "http://a0.twimg.com/sticky/default_profile_images/default_profile_1_normal.png", "created_at": "Mon Jun 27 09:17:15 +0000 2011", "follow_request_sent": false, "is_translator": false, "profile_link_color": "0084B4", "id_str": "324841714", "url": null, "default_profile": true, "contributors_enabled": false, "favourites_count": 0, "id": 324841714, "utc_offset": null, "profile_image_url_https": "https://si0.twimg.com/sticky/default_profile_images/default_profile_1_normal.png", "profile_use_background_image": true, "listed_count": 0, "lang": "en", "profile_text_color": "333333", "followers_count": 6, "protected": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "notifications": false, "geo_enabled": false, "description": null, "profile_background_color": "C0DEED", "time_zone": null, "verified": false, "statuses_count": 1, "friends_count": 27, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "default_profile_image": true, "screen_name": "bonasser789", "following": false, "show_all_inline_media": false }, { "profile_sidebar_fill_color": "E6F6F9", "profile_sidebar_border_color": "DBE9ED", "name": "GR Syber-Space", "profile_background_tile": true, "location": "Grand Rapids, MI", "profile_image_url": "http://a2.twimg.com/profile_images/1322547748/images__97__normal.jpg", "created_at": "Thu Sep 30 23:05:38 +0000 2010", "profile_link_color": "CC3366", "id_str": "197218370", "follow_request_sent": false, "is_translator": false, "url": "http://www.wix.com/castlesportsgr/myj", "default_profile": false, "favourites_count": 2, "contributors_enabled": false, "id": 197218370, "utc_offset": -18000, "profile_image_url_https": "https://si0.twimg.com/profile_images/1322547748/images__97__normal.jpg", "profile_use_background_image": true, "listed_count": 268, "lang": "en", "profile_text_color": "333333", "followers_count": 2628, "protected": true, "notifications": false, "geo_enabled": true, "profile_background_color": "DBE9ED", "description": "Welcome to Teen Gossip 411. Celebrity Gossip, Teens fashion trends for the summer 2011, Hollywood Gossip, Hotest music, Teen Websites, and more.", "time_zone": "Quito", "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/237705957/images__97_.jpg", "default_profile_image": false, "friends_count": 2846, "profile_background_image_url": "http://a2.twimg.com/profile_background_images/237705957/images__97_.jpg", "statuses_count": 7463, "show_all_inline_media": true, "screen_name": "GRSYBERSPACE", "following": false } ], "next_cursor_str": "1357643166637635702" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "is_translator": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "description": { "type": "string" }, "profile_background_color": { "type": "string" }, "verified": { "type": "boolean" }, "notifications": { "type": "boolean" }, "time_zone": { "type": "string" }, "statuses_count": { "type": "integer" }, "status": { "properties": { "coordinates": { "type": "string" }, "created_at": { "type": "string" }, "favorited": { "type": "boolean" }, "truncated": { "type": "boolean" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "text": { "type": "string" }, "contributors": { "type": "string" }, "retweet_count": { "type": "integer" }, "id": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "integer" }, "place": { "type": "string" }, "source": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "in_reply_to_status_id": { "type": "integer" } }, "type": "object" }, "profile_background_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" } } } }

URl: /lists/subscribers{mediaTypeExtension}/show
GET

#### lists subscribers{mediaTypeExtension} show

GET
/lists/subscribers{mediaTypeExtension}/show
Description
Check if the specified user is a subscriber of the specified list. Returns the user if they are subscriber. Either a list_id or a slug is required. If providing a list_slug, an owner_screen_name or owner_id is also required.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- owner_screen_name (string )
  The screen name of the user who owns the list being requested by a slug.
- owner_id (integer )
  The user ID of the user who owns the list being requested by a slug.
- list_id (integer )
  The numerical id of the list.
- slug (string )
  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 (integer )
  The ID of the user for whom to return results for. Helpful for disambiguating when a valid user ID is also a valid screen name.
- screen_name (string )
  The screen name of the user for whom to return results for. Helpful for disambiguating when a valid screen name is also a user ID.

- #### Response

- ##### Http Status code
  200

- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "previous_cursor_str": "0", "next_cursor": 1357643166637635702, "users": [ { "profile_background_tile": false, "profile_sidebar_fill_color": "DDEEF6", "name": "Almissen665", "profile_sidebar_border_color": "C0DEED", "location": null, "profile_image_url": "http://a0.twimg.com/sticky/default_profile_images/default_profile_1_normal.png", "created_at": "Mon Jun 27 09:17:15 +0000 2011", "follow_request_sent": false, "is_translator": false, "profile_link_color": "0084B4", "id_str": "324841714", "url": null, "default_profile": true, "contributors_enabled": false, "favourites_count": 0, "id": 324841714, "utc_offset": null, "profile_image_url_https": "https://si0.twimg.com/sticky/default_profile_images/default_profile_1_normal.png", "profile_use_background_image": true, "listed_count": 0, "lang": "en", "profile_text_color": "333333", "followers_count": 6, "protected": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "notifications": false, "geo_enabled": false, "description": null, "profile_background_color": "C0DEED", "time_zone": null, "verified": false, "statuses_count": 1, "friends_count": 27, "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "default_profile_image": true, "screen_name": "bonasser789", "following": false, "show_all_inline_media": false }, { "profile_sidebar_fill_color": "E6F6F9", "profile_sidebar_border_color": "DBE9ED", "name": "GR Syber-Space", "profile_background_tile": true, "location": "Grand Rapids, MI", "profile_image_url": "http://a2.twimg.com/profile_images/1322547748/images__97__normal.jpg", "created_at": "Thu Sep 30 23:05:38 +0000 2010", "profile_link_color": "CC3366", "id_str": "197218370", "follow_request_sent": false, "is_translator": false, "url": "http://www.wix.com/castlesportsgr/myj", "default_profile": false, "favourites_count": 2, "contributors_enabled": false, "id": 197218370, "utc_offset": -18000, "profile_image_url_https": "https://si0.twimg.com/profile_images/1322547748/images__97__normal.jpg", "profile_use_background_image": true, "listed_count": 268, "lang": "en", "profile_text_color": "333333", "followers_count": 2628, "protected": true, "notifications": false, "geo_enabled": true, "profile_background_color": "DBE9ED", "description": "Welcome to Teen Gossip 411. Celebrity Gossip, Teens fashion trends for the summer 2011, Hollywood Gossip, Hotest music, Teen Websites, and more.", "time_zone": "Quito", "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/237705957/images__97_.jpg", "default_profile_image": false, "friends_count": 2846, "profile_background_image_url": "http://a2.twimg.com/profile_background_images/237705957/images__97_.jpg", "statuses_count": 7463, "show_all_inline_media": true, "screen_name": "GRSYBERSPACE", "following": false } ], "next_cursor_str": "1357643166637635702" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "is_translator": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "description": { "type": "string" }, "profile_background_color": { "type": "string" }, "verified": { "type": "boolean" }, "notifications": { "type": "boolean" }, "time_zone": { "type": "string" }, "statuses_count": { "type": "integer" }, "status": { "properties": { "coordinates": { "type": "string" }, "created_at": { "type": "string" }, "favorited": { "type": "boolean" }, "truncated": { "type": "boolean" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "text": { "type": "string" }, "contributors": { "type": "string" }, "retweet_count": { "type": "integer" }, "id": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "integer" }, "place": { "type": "string" }, "source": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "in_reply_to_status_id": { "type": "integer" } }, "type": "object" }, "profile_background_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" } } } }

URl: /lists/subscribers{mediaTypeExtension}/destroy
POST

#### lists subscribers{mediaTypeExtension} destroy

POST
/lists/subscribers{mediaTypeExtension}/destroy
Description
Unsubscribes the authenticated user from the specified list. Either a list_id or a slug is required. If providing a list_slug, an owner_screen_name or owner_id is also required.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Unsubscribed successfully.

URl: /lists/members{mediaTypeExtension}
GET

#### lists members{mediaTypeExtension}

GET
/lists/members{mediaTypeExtension}
Description
Returns the members of the specified list. Private list members will only be shown if the authenticated user owns the specified list. Either a list_id or a slug is required. If providing a list_slug, an owner_screen_name or owner_id is also required.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- list_id (integer )
  The numerical id of the list.
- slug (string )
  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 (string )
  The screen name of the user who owns the list being requested by a slug.
- owner_id (integer )
  The user ID of the user who owns the list being requested by a slug.
- cursor (integer )
  Causes the collection of list members to be broken into "pages" of somewhat consistent size. If no cursor is provided, a value of -1 will be assumed, which is the first "page." The response from the API will include a previous_cursor and next_cursor to allow paging back and forth. See Using cursors to navigate collections for more information.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "previous_cursor_str": "0", "next_cursor": 0, "users": [ { "profile_sidebar_fill_color": "bedcfa", "expanded_url": null, "profile_sidebar_border_color": "85add6", "name": "Sharon Ly", "profile_background_tile": false, "location": "", "profile_image_url": "http://a2.twimg.com/profile_images/1359867172/image_normal.jpg", "created_at": "Sun May 25 00:29:44 +0000 2008", "follow_request_sent": null, "is_translator": false, "profile_link_color": "955ea6", "id_str": "14895163", "entities": { "urls": [ ], "hashtags": [ ], "user_mentions": [ ] }, "default_profile": false, "favourites_count": 63, "contributors_enabled": false, "url": null, "id": 14895163, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/1359867172/image_normal.jpg", "profile_use_background_image": true, "listed_count": 43, "lang": "en", "profile_text_color": "4c58a3", "followers_count": 784, "protected": false, "profile_background_color": "312040", "geo_enabled": true, "description": "", "time_zone": "Pacific Time (US & Canada)", "verified": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/257176598/hydrangeas_94_68830.jpg", "notifications": null, "friends_count": 188, "statuses_count": 325, "profile_background_image_url": "http://a1.twimg.com/profile_background_images/257176598/hydrangeas_94_68830.jpg", "default_profile_image": false, "status": { "coordinates": null, "truncated": false, "created_at": "Tue Jul 05 03:46:03 +0000 2011", "favorited": false, "id_str": "88091240503058432", "in_reply_to_user_id_str": "748353", "contributors": null, "text": "@kmonkeyjam Oh no... I don't know where that bone is but that sounds terribly painful. How are you still tweeting? Get better!", "id": 88091240503058432, "retweet_count": 0, "in_reply_to_status_id_str": "87979906226597888", "geo": null, "retweeted": false, "in_reply_to_user_id": 748353, "source": "<a href=\"http://twitter.com/#!/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>", "in_reply_to_screen_name": "kmonkeyjam", "place": null, "in_reply_to_status_id": 87979906226597888 }, "display_url": null, "screen_name": "onesnowclimber", "show_all_inline_media": true, "following": null } ], "next_cursor_str": "0" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "is_translator": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "description": { "type": "string" }, "profile_background_color": { "type": "string" }, "verified": { "type": "boolean" }, "notifications": { "type": "boolean" }, "time_zone": { "type": "string" }, "statuses_count": { "type": "integer" }, "status": { "properties": { "coordinates": { "type": "string" }, "created_at": { "type": "string" }, "favorited": { "type": "boolean" }, "truncated": { "type": "boolean" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "text": { "type": "string" }, "contributors": { "type": "string" }, "retweet_count": { "type": "integer" }, "id": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "integer" }, "place": { "type": "string" }, "source": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "in_reply_to_status_id": { "type": "integer" } }, "type": "object" }, "profile_background_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/members{mediaTypeExtension}/destroy{mediaTypeExtension}
POST

#### lists members{mediaTypeExtension} destroy{mediaTypeExtension}

POST
/lists/members{mediaTypeExtension}/destroy{mediaTypeExtension}
Description
Removes the specified member from the list. The authenticated user must be the list's owner to remove members from the list. Either a list_id or a slug is required. If providing a list_slug, an owner_screen_name or owner_id is also required.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Member removed from list.

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/members{mediaTypeExtension}/create_all{mediaTypeExtension}
POST

#### lists members{mediaTypeExtension} create_all{mediaTypeExtension}

POST
/lists/members{mediaTypeExtension}/create_all{mediaTypeExtension}
Description
Adds multiple members to a list, by specifying a comma-separated list of member ids or screen names. The authenticated user must own the list to be able to add members to it. Note that lists can't have more than 5,000 members, and you are limited to adding up to 100 members to a list at a time with this method. Please note that there can be issues with lists that rapidly remove and add memberships. Take care when using these methods such that you are not too rapidly switching between removals and adds on the same list. Either a list_id or a slug is required. If providing a list_slug, an owner_screen_name or owner_id is also required.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Members added.

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/members{mediaTypeExtension}/show{mediaTypeExtension}
GET

#### lists members{mediaTypeExtension} show{mediaTypeExtension}

GET
/lists/members{mediaTypeExtension}/show{mediaTypeExtension}
Description
Check if the specified user is a member of the specified list. Either a list_id or a slug is required. If providing a list_slug, an owner_screen_name or owner_id is also required.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- include_entities (string )
  The entities node will not be included when set to false.
- list_id (integer )
  The numerical id of the list.
- slug (string )
  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 (integer )
  The ID of the user for whom to return results for. Helpful for disambiguating when a valid user ID is also a valid screen name.
- screen_name (string )
  The screen name of the user for whom to return results for. Helpful for disambiguating when a valid screen name is also a user ID.
- owner_screen_name (string )
  The screen name of the user who owns the list being requested by a slug.
- owner_id (integer )
  The user ID of the user who owns the list being requested by a slug.
- skip_status (string )
  When set to either true, t or 1 statuses will not be included in the returned user objects.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "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": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>", "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" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "profile_image_url": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "is_translator": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "url": { "type": "string" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "lang": { "type": "string" }, "followers_count": { "type": "integer" }, "protected": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "geo_enabled": { "type": "boolean" }, "description": { "type": "string" }, "profile_background_color": { "type": "string" }, "verified": { "type": "boolean" }, "notifications": { "type": "boolean" }, "time_zone": { "type": "string" }, "statuses_count": { "type": "integer" }, "status": { "properties": { "coordinates": { "type": "string" }, "created_at": { "type": "string" }, "favorited": { "type": "boolean" }, "truncated": { "type": "boolean" }, "id_str": { "type": "string" }, "in_reply_to_user_id_str": { "type": "string" }, "text": { "type": "string" }, "contributors": { "type": "string" }, "retweet_count": { "type": "integer" }, "id": { "type": "integer" }, "in_reply_to_status_id_str": { "type": "string" }, "geo": { "type": "string" }, "retweeted": { "type": "boolean" }, "in_reply_to_user_id": { "type": "integer" }, "place": { "type": "string" }, "source": { "type": "string" }, "in_reply_to_screen_name": { "type": "string" }, "in_reply_to_status_id": { "type": "integer" } }, "type": "object" }, "profile_background_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "friends_count": { "type": "integer" }, "screen_name": { "type": "string" }, "following": { "type": "boolean" }, "show_all_inline_media": { "type": "boolean" } }, "type": "object" } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/members{mediaTypeExtension}/create
POST

#### lists members{mediaTypeExtension} create

POST
/lists/members{mediaTypeExtension}/create
Description
Add a member to a list. The authenticated user must own the list to be able to add members to it. Note that lists can't have more than 500 members. Either a list_id or a slug is required. If providing a list_slug, an owner_screen_name or owner_id is also required.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Member added.

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/destroy{mediaTypeExtension}
POST

#### lists destroy{mediaTypeExtension}

POST
/lists/destroy{mediaTypeExtension}
Description
Deletes the specified list. The authenticated user must own the list to be able to destroy it. Either a list_id or a slug is required. If providing a list_slug, an owner_screen_name or owner_id is also required.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "created_at": "Fri Nov 04 21:22:36 +0000 2011", "slug": "goonies", "name": "Goonies", "full_name": "@kurrik/goonies", "description": "For life", "mode": "public", "following": false, "user": { "geo_enabled": true, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/342542280/background7.png", "profile_background_color": "8fc1ff", "protected": false, "default_profile": false, "listed_count": 127, "profile_background_tile": true, "created_at": "Thu Jul 19 15:58:07 +0000 2007", "friends_count": 291, "name": "Arne Roomann-Kurrik", "profile_sidebar_fill_color": "c7e0ff", "notifications": false, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/24229162/arne001_normal.jpg", "description": "Developer Advocate at Twitter, practitioner of dark sandwich arts. ", "display_url": "roomanna.com", "following": false, "verified": false, "favourites_count": 190, "profile_sidebar_border_color": "6baeff", "followers_count": 1705, "profile_image_url": "http://a2.twimg.com/profile_images/24229162/arne001_normal.jpg", "default_profile_image": false, "contributors_enabled": false, "deactivated_bit": false, "statuses_count": 1935, "profile_use_background_image": true, "location": "Scan Francesco", "id_str": "7588892", "show_all_inline_media": false, "profile_text_color": "000000", "screen_name": "kurrik", "follow_request_sent": false, "profile_background_image_url": "http://a2.twimg.com/profile_background_images/342542280/background7.png", "url": "http://t.co/SSiVavc4", "expanded_url": "http://roomanna.com", "is_translator": false, "time_zone": "Pacific Time (US & Canada)", "profile_link_color": "0084B4", "id": 7588892, "entities": { "urls": [], "user_mentions": [], "hashtags": [] }, "suspended": false, "lang": "en" }, "member_count": 0, "id_str": "58300198", "subscriber_count": 0, "id": 58300198, "uri": "/kurrik/goonies" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "created_at": { "type": "string" }, "slug": { "type": "string" }, "name": { "type": "string" }, "full_name": { "type": "string" }, "description": { "type": "string" }, "mode": { "type": "string" }, "following": { "type": "boolean" }, "user": { "properties": { "geo_enabled": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "profile_background_color": { "type": "string" }, "protected": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_background_tile": { "type": "boolean" }, "created_at": { "type": "string" }, "friends_count": { "type": "integer" }, "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "notifications": { "type": "boolean" }, "utc_offset": { "type": "integer" }, "profile_image_url_https": { "type": "string" }, "description": { "type": "string" }, "display_url": { "type": "string" }, "following": { "type": "boolean" }, "verified": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "profile_sidebar_border_color": { "type": "string" }, "followers_count": { "type": "integer" }, "profile_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "deactivated_bit": { "type": "boolean" }, "statuses_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "location": { "type": "string" }, "id_str": { "type": "string" }, "show_all_inline_media": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "screen_name": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "profile_background_image_url": { "type": "string" }, "url": { "type": "string" }, "expanded_url": { "type": "string" }, "is_translator": { "type": "boolean" }, "time_zone": { "type": "string" }, "profile_link_color": { "type": "string" }, "id": { "type": "integer" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } } }, "type": "object" }, "member_count": { "type": "integer" }, "id_str": { "type": "string" }, "subscriber_count": { "type": "integer" }, "id": { "type": "integer" }, "uri": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/update{mediaTypeExtension}
POST

#### lists update{mediaTypeExtension}

POST
/lists/update{mediaTypeExtension}
Description
Updates the specified list. The authenticated user must own the list to be able to update it.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  List updated.

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/create{mediaTypeExtension}
POST

#### lists create{mediaTypeExtension}

POST
/lists/create{mediaTypeExtension}
Description
Creates a new list for the authenticated user. Note that you can't create more than 20 lists per account.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "created_at": "Fri Nov 04 21:22:36 +0000 2011", "slug": "goonies", "name": "Goonies", "full_name": "@kurrik/goonies", "description": "For life", "mode": "public", "following": false, "user": { "geo_enabled": true, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/342542280/background7.png", "profile_background_color": "8fc1ff", "protected": false, "default_profile": false, "listed_count": 127, "profile_background_tile": true, "created_at": "Thu Jul 19 15:58:07 +0000 2007", "friends_count": 291, "name": "Arne Roomann-Kurrik", "profile_sidebar_fill_color": "c7e0ff", "notifications": false, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/24229162/arne001_normal.jpg", "description": "Developer Advocate at Twitter, practitioner of dark sandwich arts. ", "display_url": "roomanna.com", "following": false, "verified": false, "favourites_count": 190, "profile_sidebar_border_color": "6baeff", "followers_count": 1705, "profile_image_url": "http://a2.twimg.com/profile_images/24229162/arne001_normal.jpg", "default_profile_image": false, "contributors_enabled": false, "deactivated_bit": false, "statuses_count": 1935, "profile_use_background_image": true, "location": "Scan Francesco", "id_str": "7588892", "show_all_inline_media": false, "profile_text_color": "000000", "screen_name": "kurrik", "follow_request_sent": false, "profile_background_image_url": "http://a2.twimg.com/profile_background_images/342542280/background7.png", "url": "http://t.co/SSiVavc4", "expanded_url": "http://roomanna.com", "is_translator": false, "time_zone": "Pacific Time (US & Canada)", "profile_link_color": "0084B4", "id": 7588892, "entities": { "urls": [], "user_mentions": [], "hashtags": [] }, "suspended": false, "lang": "en" }, "member_count": 0, "id_str": "58300198", "subscriber_count": 0, "id": 58300198, "uri": "/kurrik/goonies" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "created_at": { "type": "string" }, "slug": { "type": "string" }, "name": { "type": "string" }, "full_name": { "type": "string" }, "description": { "type": "string" }, "mode": { "type": "string" }, "following": { "type": "boolean" }, "user": { "properties": { "geo_enabled": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "profile_background_color": { "type": "string" }, "protected": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_background_tile": { "type": "boolean" }, "created_at": { "type": "string" }, "friends_count": { "type": "integer" }, "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "notifications": { "type": "boolean" }, "utc_offset": { "type": "integer" }, "profile_image_url_https": { "type": "string" }, "description": { "type": "string" }, "display_url": { "type": "string" }, "following": { "type": "boolean" }, "verified": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "profile_sidebar_border_color": { "type": "string" }, "followers_count": { "type": "integer" }, "profile_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "deactivated_bit": { "type": "boolean" }, "statuses_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "location": { "type": "string" }, "id_str": { "type": "string" }, "show_all_inline_media": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "screen_name": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "profile_background_image_url": { "type": "string" }, "url": { "type": "string" }, "expanded_url": { "type": "string" }, "is_translator": { "type": "boolean" }, "time_zone": { "type": "string" }, "profile_link_color": { "type": "string" }, "id": { "type": "integer" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } } }, "type": "object" }, "member_count": { "type": "integer" }, "id_str": { "type": "string" }, "subscriber_count": { "type": "integer" }, "id": { "type": "integer" }, "uri": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/show{mediaTypeExtension}
GET

#### lists show{mediaTypeExtension}

GET
/lists/show{mediaTypeExtension}
Description
Returns the specified list. Private lists will only be shown if the authenticated user owns the specified list. Either a list_id or a slug is required. If providing a list_slug, an owner_screen_name or owner_id is also required.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- list_id (integer )
  The numerical id of the list.
- slug (string )
  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 (string )
  The screen name of the user who owns the list being requested by a slug.
- owner_id (integer )
  The user ID of the user who owns the list being requested by a slug.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "created_at": "Fri Nov 04 21:22:36 +0000 2011", "slug": "goonies", "name": "Goonies", "full_name": "@kurrik/goonies", "description": "For life", "mode": "public", "following": false, "user": { "geo_enabled": true, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/342542280/background7.png", "profile_background_color": "8fc1ff", "protected": false, "default_profile": false, "listed_count": 127, "profile_background_tile": true, "created_at": "Thu Jul 19 15:58:07 +0000 2007", "friends_count": 291, "name": "Arne Roomann-Kurrik", "profile_sidebar_fill_color": "c7e0ff", "notifications": false, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/24229162/arne001_normal.jpg", "description": "Developer Advocate at Twitter, practitioner of dark sandwich arts. ", "display_url": "roomanna.com", "following": false, "verified": false, "favourites_count": 190, "profile_sidebar_border_color": "6baeff", "followers_count": 1705, "profile_image_url": "http://a2.twimg.com/profile_images/24229162/arne001_normal.jpg", "default_profile_image": false, "contributors_enabled": false, "deactivated_bit": false, "statuses_count": 1935, "profile_use_background_image": true, "location": "Scan Francesco", "id_str": "7588892", "show_all_inline_media": false, "profile_text_color": "000000", "screen_name": "kurrik", "follow_request_sent": false, "profile_background_image_url": "http://a2.twimg.com/profile_background_images/342542280/background7.png", "url": "http://t.co/SSiVavc4", "expanded_url": "http://roomanna.com", "is_translator": false, "time_zone": "Pacific Time (US & Canada)", "profile_link_color": "0084B4", "id": 7588892, "entities": { "urls": [], "user_mentions": [], "hashtags": [] }, "suspended": false, "lang": "en" }, "member_count": 0, "id_str": "58300198", "subscriber_count": 0, "id": 58300198, "uri": "/kurrik/goonies" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "created_at": { "type": "string" }, "slug": { "type": "string" }, "name": { "type": "string" }, "full_name": { "type": "string" }, "description": { "type": "string" }, "mode": { "type": "string" }, "following": { "type": "boolean" }, "user": { "properties": { "geo_enabled": { "type": "boolean" }, "profile_background_image_url_https": { "type": "string" }, "profile_background_color": { "type": "string" }, "protected": { "type": "boolean" }, "default_profile": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_background_tile": { "type": "boolean" }, "created_at": { "type": "string" }, "friends_count": { "type": "integer" }, "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "notifications": { "type": "boolean" }, "utc_offset": { "type": "integer" }, "profile_image_url_https": { "type": "string" }, "description": { "type": "string" }, "display_url": { "type": "string" }, "following": { "type": "boolean" }, "verified": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "profile_sidebar_border_color": { "type": "string" }, "followers_count": { "type": "integer" }, "profile_image_url": { "type": "string" }, "default_profile_image": { "type": "boolean" }, "contributors_enabled": { "type": "boolean" }, "deactivated_bit": { "type": "boolean" }, "statuses_count": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "location": { "type": "string" }, "id_str": { "type": "string" }, "show_all_inline_media": { "type": "boolean" }, "profile_text_color": { "type": "string" }, "screen_name": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "profile_background_image_url": { "type": "string" }, "url": { "type": "string" }, "expanded_url": { "type": "string" }, "is_translator": { "type": "boolean" }, "time_zone": { "type": "string" }, "profile_link_color": { "type": "string" }, "id": { "type": "integer" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } } }, "type": "object" }, "member_count": { "type": "integer" }, "id_str": { "type": "string" }, "subscriber_count": { "type": "integer" }, "id": { "type": "integer" }, "uri": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/subscriptions{mediaTypeExtension}
GET

#### lists subscriptions{mediaTypeExtension}

GET
/lists/subscriptions{mediaTypeExtension}
Description
Obtain a collection of the lists the specified user is subscribed to, 20 lists per page by default. Does not include the user's own lists. A user_id or screen_name must be provided.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- user_id (integer )
  The ID of the user for whom to return results for. Helpful for disambiguating when a valid user ID is also a valid screen name.
- screen_name (string )
  The screen name of the user for whom to return results for. Helpful for disambiguating when a valid screen name is also a user ID.
- count (integer )
  The amount of results to return per page. Defaults to 20. No more than 1000 results will ever be returned in a single page.
- cursor (integer )
  Breaks the results into pages. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list. It is recommended to always use cursors when the method supports them. See Using cursors to navigate collections for more information.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "previous_cursor": 0, "lists": [ { "slug": "team", "name": "team", "uri": "/TwitterEng/team", "created_at": "Mon Oct 03 02:48:07 +0000 2011", "subscriber_count": 131, "id_str": "55932616", "member_count": 324, "mode": "public", "id": 55932616, "full_name": "@TwitterEng/team", "description": "", "user": { "profile_sidebar_border_color": "C6E2EE", "profile_sidebar_fill_color": "DAECF4", "profile_background_tile": false, "expanded_url": null, "name": "Twitter Engineering", "location": "San Francisco, CA", "created_at": "Sat Jun 16 00:14:36 +0000 2007", "profile_image_url": "http://a2.twimg.com/profile_images/1262149685/twitter_newbird_boxed_blueonwhite_normal.png", "is_translator": false, "profile_link_color": "1F98C7", "follow_request_sent": null, "id_str": "6844292", "entities": { "urls": [ ], "hashtags": [ ], "user_mentions": [ ] }, "url": "http://engineering.twitter.com", "default_profile": false, "favourites_count": 0, "contributors_enabled": true, "id": 6844292, "utc_offset": -14400, "profile_image_url_https": "https://si0.twimg.com/profile_images/1262149685/twitter_newbird_boxed_blueonwhite_normal.png", "profile_use_background_image": true, "listed_count": 1493, "profile_text_color": "663B12", "lang": "en", "followers_count": 132674, "protected": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme2/bg.gif", "verified": true, "geo_enabled": true, "notifications": null, "time_zone": "Atlantic Time (Canada)", "description": "The official account for Twitter Engineering.", "profile_background_color": "C6E2EE", "profile_background_image_url": "http://a1.twimg.com/images/themes/theme2/bg.gif", "default_profile_image": false, "statuses_count": 61, "friends_count": 0, "display_url": null, "screen_name": "TwitterEng", "following": null, "show_all_inline_media": true }, "following": false }, { "slug": "the-brain-trust", "name": "The Brain Trust", "uri": "/LTRK140/the-brain-trust", "created_at": "Sun Mar 06 20:01:50 +0000 2011", "subscriber_count": 24, "id_str": "37396827", "member_count": 148, "mode": "public", "id": 37396827, "full_name": "@LTRK140/the-brain-trust", "description": "Twitter Artists, Ascii, Unicode Art.", "user": { "profile_sidebar_border_color": "080000", "profile_sidebar_fill_color": "", "profile_background_tile": true, "name": "-", "location": "Toronto", "created_at": "Fri Jun 04 16:48:39 +0000 2010", "profile_image_url": "http://a1.twimg.com/profile_images/1315622089/Cool_Daddy_normal.png", "is_translator": false, "profile_link_color": "080000", "follow_request_sent": false, "id_str": "151938348", "url": "http://twitter.com/KREWZO", "favourites_count": 10, "contributors_enabled": false, "default_profile": false, "id": 151938348, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/1315622089/Cool_Daddy_normal.png", "profile_use_background_image": true, "listed_count": 131, "profile_text_color": "000000", "lang": "en", "followers_count": 838, "protected": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/285103295/ltrk140.JPG", "verified": false, "geo_enabled": true, "notifications": false, "time_zone": "Pacific Time (US & Canada)", "description": "─ \r\n 140 ASCII UNICODE ART BY OZ MELO I LIVE & WORK IN #YYZ. MOST TWEETS ARE BEST VIEWED AS A STATUS PAGE ", "profile_background_color": "030003", "profile_background_image_url": "http://a1.twimg.com/profile_background_images/285103295/ltrk140.JPG", "default_profile_image": false, "statuses_count": 1006, "friends_count": 139, "screen_name": "LTRK140", "following": false, "show_all_inline_media": true }, "following": false }, { "slug": "twoutside-lands", "name": "Twoutside Lands", "uri": "/dannyhertz/twoutside-lands", "created_at": "Fri Aug 12 07:21:25 +0000 2011", "subscriber_count": 12, "id_str": "52270561", "member_count": 25, "mode": "public", "id": 52270561, "full_name": "@dannyhertz/twoutside-lands", "description": "Tweeps @ Outside Lands 2011", "user": { "profile_sidebar_border_color": "4685e3", "profile_sidebar_fill_color": "c7dced", "profile_background_tile": false, "expanded_url": "http://www.dannyhertz.com", "name": "Danny Hertz", "location": "San Francisco", "created_at": "Sat Nov 15 02:26:09 +0000 2008", "profile_image_url": "http://a0.twimg.com/profile_images/1546221308/6153868543_d7ab87737a_b_normal.jpeg", "is_translator": true, "profile_link_color": "005082", "follow_request_sent": false, "id_str": "17400516", "entities": { "urls": [ ], "hashtags": [ ], "user_mentions": [ ] }, "url": "http://t.co/90RtgWI", "favourites_count": 243, "contributors_enabled": false, "default_profile": false, "id": 17400516, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/1546221308/6153868543_d7ab87737a_b_normal.jpeg", "profile_use_background_image": true, "listed_count": 52, "profile_text_color": "000000", "lang": "en", "followers_count": 2684, "protected": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/331345358/pamperedpuppy20091103.jpeg", "verified": false, "geo_enabled": true, "notifications": false, "time_zone": "Pacific Time (US & Canada)", "description": "Software Engineer on the User Services team at Twitter and lead singer for the rock band Journey.", "profile_background_color": "ffffff", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/331345358/pamperedpuppy20091103.jpeg", "default_profile_image": false, "statuses_count": 2318, "friends_count": 261, "display_url": "dannyhertz.com", "screen_name": "dannyhertz", "following": false, "show_all_inline_media": true }, "following": false }, { "slug": "july-6-curators", "name": "July 6 curators", "uri": "/townhall/july-6-curators", "created_at": "Mon Jul 04 20:37:28 +0000 2011", "subscriber_count": 58, "id_str": "49286494", "member_count": 8, "mode": "public", "id": 49286494, "full_name": "@townhall/july-6-curators", "description": "Curators helping for the Town Hall at the White House on July 6th at 2pm ET", "user": { "profile_sidebar_border_color": "C0DEED", "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": true, "name": "Town Hall", "location": "", "created_at": "Tue May 31 01:50:52 +0000 2011", "profile_image_url": "http://a2.twimg.com/profile_images/1419432899/avatar_normal.png", "is_translator": false, "profile_link_color": "0084B4", "follow_request_sent": null, "id_str": "308230587", "url": "http://askobama.twitter.com", "default_profile": false, "favourites_count": 0, "contributors_enabled": true, "id": 308230587, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/profile_images/1419432899/avatar_normal.png", "profile_use_background_image": true, "listed_count": 517, "profile_text_color": "333333", "lang": "en", "followers_count": 24456, "protected": false, "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/280500767/bg.jpg", "verified": true, "geo_enabled": false, "notifications": null, "time_zone": "Pacific Time (US & Canada)", "description": "Official account for Twitter hosted town halls. Our first on July 6th, 2PM ET. ", "profile_background_color": "C0DEED", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/280500767/bg.jpg", "default_profile_image": false, "statuses_count": 100, "friends_count": 2, "screen_name": "townhall", "following": null, "show_all_inline_media": true }, "following": false }, { "slug": "streaming-music-industry", "name": "Streaming Music Industry ", "uri": "/meetmarshall/streaming-music-industry", "created_at": "Thu Mar 31 04:04:10 +0000 2011", "subscriber_count": 193, "id_str": "41857276", "member_count": 1, "mode": "public", "id": 41857276, "full_name": "@meetmarshall/streaming-music-industry", "description": "A custom list created by adding, subtracting or filtering existing lists (made using @formulists)", "user": { "profile_sidebar_border_color": "C0DEED", "profile_sidebar_fill_color": "DDEEF6", "profile_background_tile": false, "name": "Marshall Kirkpatrick", "location": "", "created_at": "Mon Mar 28 20:18:47 +0000 2011", "profile_image_url": "http://a3.twimg.com/sticky/default_profile_images/default_profile_0_normal.png", "is_translator": false, "profile_link_color": "0084B4", "follow_request_sent": false, "id_str": "273602749", "url": "http://twitter.com/marshallk", "default_profile": true, "favourites_count": 0, "contributors_enabled": false, "id": 273602749, "utc_offset": -28800, "profile_image_url_https": "https://si0.twimg.com/sticky/default_profile_images/default_profile_0_normal.png", "profile_use_background_image": true, "listed_count": 3, "profile_text_color": "333333", "lang": "en", "followers_count": 29, "protected": false, "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png", "verified": false, "geo_enabled": false, "notifications": false, "time_zone": "Pacific Time (US & Canada)", "description": "I just came for the lists.", "profile_background_color": "C0DEED", "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png", "default_profile_image": true, "statuses_count": 3, "friends_count": 146, "screen_name": "meetmarshall", "following": false, "show_all_inline_media": false }, "following": false } ], "previous_cursor_str": "0", "next_cursor": 1364811190668631091, "next_cursor_str": "1364811190668631091" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "slug": { "type": "string" }, "name": { "type": "string" }, "created_at": { "type": "string" }, "uri": { "type": "string" }, "subscriber_count": { "type": "integer" }, "id_str": { "type": "string" }, "member_count": { "type": "integer" }, "mode": { "type": "string" }, "id": { "type": "integer" }, "full_name": { "type": "string" }, "description": { "type": "string" }, "user": { "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "profile_image_url": { "type": "string" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "profile_banner_url": { "type": "string" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "protected": { "type": "boolean" }, "lang": "en", "followers_count": { "type": "integer" }, "description": { "type": "string" }, "notifications": { "type": "boolean" }, "geo_enabled": { "type": "boolean" }, "verified": { "type": "boolean" }, "time_zone": { "type": "string" }, "profile_background_color": { "type": "string" }, "profile_background_image_url_https": { "type": "string" }, "statuses_count": { "type": "integer" }, "friends_count": { "type": "integer" }, "default_profile_image": { "type": "boolean" }, "profile_background_image_url": { "type": "string" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" } }, "following": { "type": "boolean" } }, "type": "object" } }, "type": "array" } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/members/destroy_all{mediaTypeExtension}
POST

#### lists members destroy_all{mediaTypeExtension}

POST
/lists/members/destroy_all{mediaTypeExtension}
Description
Removes multiple members from a list, by specifying a comma-separated list of member ids or screen names. The authenticated user must own the list to be able to remove members from it. Note that lists can't have more than 500 members, and you are limited to removing up to 100 members to a list at a time with this method. Please note that there can be issues with lists that rapidly remove and add memberships. Take care when using these methods such that you are not too rapidly switching between removals and adds on the same list. Either a list_id or a slug is required. If providing a list_slug, an owner_screen_name or owner_id is also required.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Members was removed from the list.

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /lists/ownerships{mediaTypeExtension}
GET

#### lists ownerships{mediaTypeExtension}

GET
/lists/ownerships{mediaTypeExtension}
Description
Returns the lists owned by the specified Twitter user. Private lists will only be shown if the authenticated user is also the owner of the lists. A user_id or screen_name must be provided.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- user_id (integer )
  The ID of the user for whom to return results for.
- screen_name (string )
  The screen name of the user for whom to return results for.
- count (integer )
  The amount of results to return per page. Defaults to 20. No more than 1000 results will ever be returned in a single page.
- cursor (string )
  Breaks the results into pages. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list. It is recommended to always use cursors when the method supports them. See Using cursors to navigate collections for more information.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "slug": "meetup-20100301", "name": "meetup-20100301", "created_at": "Sat Feb 27 21:39:24 +0000 2010", "uri": "/twitterapi/meetup-20100301", "subscriber_count": 147, "id_str": "8044403", "member_count": 116, "mode": "public", "id": 8044403, "full_name": "@twitterapi/meetup-20100301", "description": "Guests attending the Twitter meetup on 1 March 2010 at the @twoffice", "user": { "profile_background_tile": true, "profile_sidebar_border_color": "C0DEED", "name": "Twitter API", "profile_sidebar_fill_color": "DDEEF6", "location": "San Francisco, CA", "created_at": "Wed May 23 06:01:13 +0000 2007", "profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "is_translator": false, "id_str": "6253282", "profile_link_color": "0084B4", "follow_request_sent": false, "favourites_count": 25, "contributors_enabled": true, "url": "http://dev.twitter.com", "default_profile": false, "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "utc_offset": -28800, "profile_banner_url": "https://si0.twimg.com/profile_banners/6253282/1347394302", "id": 6253282, "profile_use_background_image": true, "listed_count": 11201, "profile_text_color": "333333", "protected": false, "lang": "en", "followers_count": 1444739, "description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.", "notifications": false, "geo_enabled": true, "verified": true, "time_zone": "Pacific Time (US & Canada)", "profile_background_color": "C0DEED", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png", "statuses_count": 3367, "friends_count": 33, "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png", "following": true, "screen_name": "twitterapi" }, "following": false }, { "slug": "team", "name": "team", "created_at": "Wed Nov 04 01:24:28 +0000 2009", "uri": "/twitterapi/team", "subscriber_count": 277, "id_str": "2031945", "member_count": 20, "mode": "public", "id": 2031945, "full_name": "@twitterapi/team", "description": "", "user": { "profile_background_tile": true, "profile_sidebar_border_color": "C0DEED", "name": "Twitter API", "profile_sidebar_fill_color": "DDEEF6", "location": "San Francisco, CA", "created_at": "Wed May 23 06:01:13 +0000 2007", "profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "is_translator": false, "id_str": "6253282", "profile_link_color": "0084B4", "follow_request_sent": false, "favourites_count": 25, "contributors_enabled": true, "url": "http://dev.twitter.com", "default_profile": false, "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png", "utc_offset": -28800, "profile_banner_url": "https://si0.twimg.com/profile_banners/6253282/1347394302", "id": 6253282, "profile_use_background_image": true, "listed_count": 11201, "profile_text_color": "333333", "protected": false, "lang": "en", "followers_count": 1444739, "description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.", "notifications": false, "geo_enabled": true, "verified": true, "time_zone": "Pacific Time (US & Canada)", "profile_background_color": "C0DEED", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png", "statuses_count": 3367, "friends_count": 33, "default_profile_image": false, "profile_background_image_url": "http://a0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png", "following": true, "screen_name": "twitterapi" }, "following": true } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "properties": { "slug": { "type": "string" }, "name": { "type": "string" }, "created_at": { "type": "string" }, "uri": { "type": "string" }, "subscriber_count": { "type": "integer" }, "id_str": { "type": "string" }, "member_count": { "type": "integer" }, "mode": { "type": "string" }, "id": { "type": "integer" }, "full_name": { "type": "string" }, "description": { "type": "string" }, "user": { "profile_background_tile": { "type": "boolean" }, "profile_sidebar_border_color": { "type": "string" }, "name": { "type": "string" }, "profile_sidebar_fill_color": { "type": "string" }, "location": { "type": "string" }, "created_at": { "type": "string" }, "profile_image_url": { "type": "string" }, "is_translator": { "type": "boolean" }, "id_str": { "type": "string" }, "profile_link_color": { "type": "string" }, "follow_request_sent": { "type": "boolean" }, "favourites_count": { "type": "integer" }, "contributors_enabled": { "type": "boolean" }, "entities": { "media": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "media_url": { "type": "string" }, "media_url_https": { "type": "string" }, "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "sizes": { "large": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": { "0": "crop", "1": "fit" }, "h": { "type": "integer" } } }, "type": "array", "indices": { "0": { "type": "integer" } } }, "type": "object" } }, "type": "array", "urls": { "0": { "properties": { "url": { "type": "string" }, "display_url": { "type": "string" }, "expanded_url": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "hashtags": { "0": { "properties": { "text": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } }, "user_mentions": { "0": { "properties": { "id": { "type": "integer" }, "id_str": { "type": "string" }, "screen_name": { "type": "string" }, "name": { "type": "string" }, "indices": { "0": { "type": "integer" } }, "type": "array" }, "type": "object" } } }, "url": { "type": "string" }, "default_profile": { "type": "boolean" }, "profile_image_url_https": { "type": "string" }, "utc_offset": { "type": "integer" }, "profile_banner_url": { "type": "string" }, "id": { "type": "integer" }, "profile_use_background_image": { "type": "boolean" }, "listed_count": { "type": "integer" }, "profile_text_color": { "type": "string" }, "protected": { "type": "boolean" }, "lang": "en", "followers_count": { "type": "integer" }, "description": { "type": "string" }, "notifications": { "type": "boolean" }, "geo_enabled": { "type": "boolean" }, "verified": { "type": "boolean" }, "time_zone": { "type": "string" }, "profile_background_color": { "type": "string" }, "profile_background_image_url_https": { "type": "string" }, "statuses_count": { "type": "integer" }, "friends_count": { "type": "integer" }, "default_profile_image": { "type": "boolean" }, "profile_background_image_url": { "type": "string" }, "following": { "type": "boolean" }, "screen_name": { "type": "string" } }, "following": { "type": "boolean" } }, "type": "object" } }, "type": "array" } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /saved_searches

#### saved_searches

URl: /saved_searches/list{mediaTypeExtension}
GET

#### saved_searches list{mediaTypeExtension}

GET
/saved_searches/list{mediaTypeExtension}
Description
Returns the authenticated user's saved search queries.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "created_at": "Tue Jun 15 09:37:24 +0000 2010", "id": 9569704, "id_str": "9569704", "name": "@twitterapi", "position": null, "query": "@twitterapi" }, { "created_at": "Tue Jun 15 09:38:04 +0000 2010", "id": 9569730, "id_str": "9569730", "name": "@twitter OR twitterapi OR \"twitter api\" OR \"@anywhere\"", "position": null, "query": "@twitter OR twitterapi OR \"twitter api\" OR \"@anywhere\"" } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "properties": { "created_at": { "type": "string" }, "id": { "type": "integer" }, "id_str": { "type": "string" }, "name": { "type": "string" }, "position": { "type": "string" }, "query": { "type": "string" } }, "type": "object" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /saved_searches/show/{id}
GET

#### saved_searches show {id}

GET
/saved_searches/show/{id}
Description
Retrieve the information for the saved search represented by the given id. The authenticating user must be the owner of saved search ID being requested.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.
- id (integer )
  The ID of the saved search.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "created_at": "Fri Nov 04 18:46:41 +0000 2011", "id": 62353170, "id_str": "62353170", "name": "@anywhere", "position": null, "query": "@anywhere" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "created_at": { "type": "string" }, "id": { "type": "integer" }, "id_str": { "type": "string" }, "name": { "type": "string" }, "position": { "type": "string" }, "query": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /saved_searches/create{mediaTypeExtension}
POST

#### saved_searches create{mediaTypeExtension}

POST
/saved_searches/create{mediaTypeExtension}
Description
Create a new saved search for the authenticated user. A user may only have 25 saved searches.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "created_at": "Fri Nov 04 18:46:41 +0000 2011", "id": 62353170, "id_str": "62353170", "name": "@anywhere", "position": null, "query": "@anywhere" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "created_at": { "type": "string" }, "id": { "type": "integer" }, "id_str": { "type": "string" }, "name": { "type": "string" }, "position": { "type": "string" }, "query": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /saved_searches/destroy/{id}
POST

#### saved_searches destroy {id}

POST
/saved_searches/destroy/{id}
Description
Destroys a saved search for the authenticating user. The authenticating user must be the owner of saved search id being destroyed.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.
- id (integer )
  The ID of the saved search.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "created_at": "Fri Nov 04 18:46:41 +0000 2011", "id": 62353170, "id_str": "62353170", "name": "@anywhere", "position": null, "query": "@anywhere" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "created_at": { "type": "string" }, "id": { "type": "integer" }, "id_str": { "type": "string" }, "name": { "type": "string" }, "position": { "type": "string" }, "query": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /geo

#### geo

URl: /geo/id/{place_id}{mediaTypeExtension}
GET

#### geo id {place_id}{mediaTypeExtension}

GET
/geo/id/{place_id}{mediaTypeExtension}
Description
Returns all the information about a known place.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.
- place_id (string )
  A place in the world. These IDs can be retrieved from geo/reverse_geocode.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "attributes": { "162834:id": "2202" }, "bounding_box": { "coordinates": [ [ [ -122.48530488, 37.78695297 ], [ -122.44625208, 37.78695297 ], [ -122.44625208, 37.81082799 ], [ -122.48530488, 37.81082799 ] ] ], "type": "Polygon" }, "contained_within": [ { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -122.51368188, 37.70813196 ], [ -122.35845384, 37.70813196 ], [ -122.35845384, 37.83245301 ], [ -122.51368188, 37.83245301 ] ] ], "type": "Polygon" }, "country": "United States", "country_code": "US", "full_name": "San Francisco, CA", "id": "5a110d312052166f", "name": "San Francisco", "place_type": "city", "url": "https://api.twitter.com/1.1/geo/id/5a110d312052166f.json" } ], "country": "United States", "country_code": "US", "full_name": "Presidio, San Francisco", "geometry": { "coordinates": [ [ [ -122.48530488, 37.79186004 ], [ -122.48004096, 37.80269298 ], [ -122.47808292, 37.81082799 ], [ -122.46734592, 37.80748701 ], [ -122.46333192, 37.80480897 ], [ -122.44708188, 37.80742797 ], [ -122.44807116, 37.805211 ], [ -122.44625208, 37.79193096 ], [ -122.47134804, 37.78695297 ], [ -122.48418312, 37.78752897 ], [ -122.482854, 37.78855596 ], [ -122.48530488, 37.79186004 ] ] ], "type": "Polygon" }, "id": "df51dec6f4ee2b2c", "name": "Presidio", "place_type": "neighborhood", "polylines": [ "cfteFb|qjVubA{_@{q@gKzSabAvOcXkOqdBzLdE~qAkJb^z{CsBdoAmEiGsShN" ], "url": "https://api.twitter.com/1.1/geo/id/df51dec6f4ee2b2c.json" }

  ###### Schema

  { "type": "object", "$schema": "http://json-schema.org/draft-03/schema", "properties": { "attributes": { "type": "object", "properties": { "162834:id": { "type": "string" } } }, "bounding_box": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "contained_within": { "type": "array", "items": { "type": "object", "properties": { "attributes": { "type": "object" }, "bounding_box": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "country_code": { "type": "string" }, "country": { "type": "string" }, "full_name": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "place_type": { "type": "string" }, "url": { "type": "string" } } } }, "country_code": { "type": "string" }, "country": { "type": "string" }, "full_name": { "type": "string" }, "geometry": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "id": { "type": "string" }, "name": { "type": "string" }, "place_type": { "type": "string" }, "polylines": { "type": "array", "items": { "type": "string" } }, "url": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /geo/reverse_geocode{mediaTypeExtension}
GET

#### geo reverse_geocode{mediaTypeExtension}

GET
/geo/reverse_geocode{mediaTypeExtension}
Description
Given a latitude and a longitude, searches for up to 20 places that can be used as a place_id when updating a status. This request is an informative call and will deliver generalized results about geography.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- lat (number )
  The latitude to search around. This parameter will be ignored unless it is inside the range -90.0 to +90.0 (North is positive) inclusive. It will also be ignored if there isn't a corresponding long parameter.
- long (number )
  The longitude to search around. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This parameter will be ignored if outside that range, if it is not a number, if geo_enabled is disabled, or if there not a corresponding lat parameter.
- accuracy (string )
  A hint on the "region" in which to search. If a number, then this is a radius in meters, but it can also take a string that is suffixed with ft to specify feet. If this is not passed in, then it is assumed to be 0m. If coming from a device, in practice, this value is whatever accuracy the device has measuring its location (whether it be coming from a GPS, WiFi triangulation, etc.).
- granularity (string )
  This is the minimal granularity of place types to return and must be one of: poi, neighborhood, city, admin or country. If no granularity is provided for the request neighborhood is assumed. Setting this to city, for example, will find places which have a type of city, admin or country.
- max_results (integer )
  A hint as to the number of results to return. This does not guarantee that the number of results returned will equal max_results, but instead informs how many "nearby" results to return. Ideally, only pass in the number of places you intend to display to the user here.
- callback (string )
  If supplied, the response will use the JSONP format with a callback of the given name.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "query": { "params": { "accuracy": 0, "coordinates": { "coordinates": [ -122.42284884, 37.76893497 ], "type": "Point" }, "granularity": "neighborhood" }, "type": "reverse_geocode", "url": "https://api.twitter.com/1.1/geo/reverse_geocode.json?accuracy=0&granularity=neighborhood&lat=37.76893497&long=-122.42284884" }, "result": { "places": [ { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -122.42676492, 37.75983003 ], [ -122.420736, 37.75983003 ], [ -122.420736, 37.77226299 ], [ -122.42676492, 37.77226299 ] ] ], "type": "Polygon" }, "contained_within": [ { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -122.51368188, 37.70813196 ], [ -122.35845384, 37.70813196 ], [ -122.35845384, 37.83245301 ], [ -122.51368188, 37.83245301 ] ] ], "type": "Polygon" }, "country": "United States", "country_code": "US", "full_name": "San Francisco, CA", "id": "5a110d312052166f", "name": "San Francisco", "place_type": "city", "url": "https://api.twitter.com/1.1/geo/id/5a110d312052166f.json" } ], "country": "United States", "country_code": "US", "full_name": "Mission Dolores, San Francisco", "id": "cf7afb4ee6011bca", "name": "Mission Dolores", "place_type": "neighborhood", "url": "https://api.twitter.com/1.1/geo/id/cf7afb4ee6011bca.json" }, { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -122.51368188, 37.70813196 ], [ -122.35845384, 37.70813196 ], [ -122.35845384, 37.83245301 ], [ -122.51368188, 37.83245301 ] ] ], "type": "Polygon" }, "contained_within": [ { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -124.482003, 32.528832 ], [ -114.131211, 32.528832 ], [ -114.131211, 42.009517 ], [ -124.482003, 42.009517 ] ] ], "type": "Polygon" }, "country": "United States", "country_code": "US", "full_name": "California, US", "id": "fbd6d2f5a4e4a15e", "name": "California", "place_type": "admin", "url": "https://api.twitter.com/1.1/geo/id/fbd6d2f5a4e4a15e.json" } ], "country": "United States", "country_code": "US", "full_name": "San Francisco, CA", "id": "5a110d312052166f", "name": "San Francisco", "place_type": "city", "url": "https://api.twitter.com/1.1/geo/id/5a110d312052166f.json" }, { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -124.482003, 32.528832 ], [ -114.131211, 32.528832 ], [ -114.131211, 42.009517 ], [ -124.482003, 42.009517 ] ] ], "type": "Polygon" }, "contained_within": [ { "attributes": {}, "bounding_box": null, "country": "United States", "country_code": "US", "full_name": "United States", "id": "96683cc9126741d1", "name": "United States", "place_type": "country", "url": "https://api.twitter.com/1.1/geo/id/96683cc9126741d1.json" } ], "country": "United States", "country_code": "US", "full_name": "California, US", "id": "fbd6d2f5a4e4a15e", "name": "California", "place_type": "admin", "url": "https://api.twitter.com/1.1/geo/id/fbd6d2f5a4e4a15e.json" }, { "attributes": {}, "bounding_box": null, "contained_within": [], "country": "United States", "country_code": "US", "full_name": "United States", "id": "96683cc9126741d1", "name": "United States", "place_type": "country", "url": "https://api.twitter.com/1.1/geo/id/96683cc9126741d1.json" } ] } }

  ###### Schema

  { "type": "object", "$schema": "http://json-schema.org/draft-03/schema", "properties": { "attributes": { "type": "object", "properties": { "162834:id": { "type": "string" } } }, "bounding_box": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "contained_within": { "type": "array", "items": { "type": "object", "properties": { "attributes": { "type": "object" }, "bounding_box": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "country_code": { "type": "string" }, "country": { "type": "string" }, "full_name": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "place_type": { "type": "string" }, "url": { "type": "string" } } } }, "country_code": { "type": "string" }, "country": { "type": "string" }, "full_name": { "type": "string" }, "geometry": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "id": { "type": "string" }, "name": { "type": "string" }, "place_type": { "type": "string" }, "polylines": { "type": "array", "items": { "type": "string" } }, "url": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /geo/search{mediaTypeExtension}
GET

#### geo search{mediaTypeExtension}

GET
/geo/search{mediaTypeExtension}
Description
Search for places that can be attached to a statuses/update. Given a latitude and a longitude pair, an IP address, or a name, this request will return a list of all the valid places that can be used as the place_id when updating a status. Conceptually, a query can be made from the user's location, retrieve a list of places, have the user validate the location he or she is at, and then send the ID of this location with a call to POST statuses/update. This is the recommended method to use find places that can be attached to statuses/update. Unlike GET geo/reverse_geocode which provides raw data access, this endpoint can potentially re-order places with regards to the user who is authenticated. This approach is also preferred for interactive place matching with the user.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- lat (number )
  The latitude to search around. This parameter will be ignored unless it is inside the range -90.0 to +90.0 (North is positive) inclusive. It will also be ignored if there isn't a corresponding long parameter.
- long (number )
  The longitude to search around. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This parameter will be ignored if outside that range, if it is not a number, if geo_enabled is disabled, or if there not a corresponding lat parameter.
- query (string )
  Free-form text to match against while executing a geo-based query, best suited for finding nearby locations by name. Remember to URL encode the query.
- ip (string )
  An IP address. Used when attempting to fix geolocation based off of the user's IP address.
- granularity (string )
  This is the minimal granularity of place types to return and must be one of: poi, neighborhood, city, admin or country. If no granularity is provided for the request neighborhood is assumed. Setting this to city, for example, will find places which have a type of city, admin or country.
- accuracy (string )
  A hint on the "region" in which to search. If a number, then this is a radius in meters, but it can also take a string that is suffixed with ft to specify feet. If this is not passed in, then it is assumed to be 0m. If coming from a device, in practice, this value is whatever accuracy the device has measuring its location (whether it be coming from a GPS, WiFi triangulation, etc.).
- max_results (integer )
  A hint as to the number of results to return. This does not guarantee that the number of results returned will equal max_results, but instead informs how many "nearby" results to return. Ideally, only pass in the number of places you intend to display to the user here.
- contained_within (string )
  This is the place_id which you would like to restrict the search results to. Setting this value means only places within the given place_id will be found. Specify a place_id. For example, to scope all results to places within "San Francisco, CA USA", you would specify a place_id of "5a110d312052166f"
- ? "attribute:street_address" (string )
  This parameter searches for places which have this given street address. There are other well-known, and application specific attributes available. Custom attributes are also permitted. Learn more about Place Attributes.
- callback (string )
  If supplied, the response will use the JSONP format with a callback of the given name.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "query": { "params": { "accuracy": 0, "coordinates": { "coordinates": [ -122.42284884, 37.76893497 ], "type": "Point" }, "granularity": "neighborhood" }, "type": "reverse_geocode", "url": "https://api.twitter.com/1.1/geo/reverse_geocode.json?accuracy=0&granularity=neighborhood&lat=37.76893497&long=-122.42284884" }, "result": { "places": [ { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -122.42676492, 37.75983003 ], [ -122.420736, 37.75983003 ], [ -122.420736, 37.77226299 ], [ -122.42676492, 37.77226299 ] ] ], "type": "Polygon" }, "contained_within": [ { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -122.51368188, 37.70813196 ], [ -122.35845384, 37.70813196 ], [ -122.35845384, 37.83245301 ], [ -122.51368188, 37.83245301 ] ] ], "type": "Polygon" }, "country": "United States", "country_code": "US", "full_name": "San Francisco, CA", "id": "5a110d312052166f", "name": "San Francisco", "place_type": "city", "url": "https://api.twitter.com/1.1/geo/id/5a110d312052166f.json" } ], "country": "United States", "country_code": "US", "full_name": "Mission Dolores, San Francisco", "id": "cf7afb4ee6011bca", "name": "Mission Dolores", "place_type": "neighborhood", "url": "https://api.twitter.com/1.1/geo/id/cf7afb4ee6011bca.json" }, { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -122.51368188, 37.70813196 ], [ -122.35845384, 37.70813196 ], [ -122.35845384, 37.83245301 ], [ -122.51368188, 37.83245301 ] ] ], "type": "Polygon" }, "contained_within": [ { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -124.482003, 32.528832 ], [ -114.131211, 32.528832 ], [ -114.131211, 42.009517 ], [ -124.482003, 42.009517 ] ] ], "type": "Polygon" }, "country": "United States", "country_code": "US", "full_name": "California, US", "id": "fbd6d2f5a4e4a15e", "name": "California", "place_type": "admin", "url": "https://api.twitter.com/1.1/geo/id/fbd6d2f5a4e4a15e.json" } ], "country": "United States", "country_code": "US", "full_name": "San Francisco, CA", "id": "5a110d312052166f", "name": "San Francisco", "place_type": "city", "url": "https://api.twitter.com/1.1/geo/id/5a110d312052166f.json" }, { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -124.482003, 32.528832 ], [ -114.131211, 32.528832 ], [ -114.131211, 42.009517 ], [ -124.482003, 42.009517 ] ] ], "type": "Polygon" }, "contained_within": [ { "attributes": {}, "bounding_box": null, "country": "United States", "country_code": "US", "full_name": "United States", "id": "96683cc9126741d1", "name": "United States", "place_type": "country", "url": "https://api.twitter.com/1.1/geo/id/96683cc9126741d1.json" } ], "country": "United States", "country_code": "US", "full_name": "California, US", "id": "fbd6d2f5a4e4a15e", "name": "California", "place_type": "admin", "url": "https://api.twitter.com/1.1/geo/id/fbd6d2f5a4e4a15e.json" }, { "attributes": {}, "bounding_box": null, "contained_within": [], "country": "United States", "country_code": "US", "full_name": "United States", "id": "96683cc9126741d1", "name": "United States", "place_type": "country", "url": "https://api.twitter.com/1.1/geo/id/96683cc9126741d1.json" } ] } }

  ###### Schema

  { "type": "object", "$schema": "http://json-schema.org/draft-03/schema", "properties": { "attributes": { "type": "object", "properties": { "162834:id": { "type": "string" } } }, "bounding_box": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "contained_within": { "type": "array", "items": { "type": "object", "properties": { "attributes": { "type": "object" }, "bounding_box": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "country_code": { "type": "string" }, "country": { "type": "string" }, "full_name": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "place_type": { "type": "string" }, "url": { "type": "string" } } } }, "country_code": { "type": "string" }, "country": { "type": "string" }, "full_name": { "type": "string" }, "geometry": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "id": { "type": "string" }, "name": { "type": "string" }, "place_type": { "type": "string" }, "polylines": { "type": "array", "items": { "type": "string" } }, "url": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /geo/similar_places{mediaTypeExtension}
GET

#### geo similar_places{mediaTypeExtension}

GET
/geo/similar_places{mediaTypeExtension}
Description
Locates places near the given coordinates which are similar in name. Conceptually you would use this method to get a list of known places to choose from first. Then, if the desired place doesn't exist, make a request to POST geo/place to create a new one. The token contained in the response is the token needed to be able to create a new place.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- lat (number )
  The latitude to search around. This parameter will be ignored unless it is inside the range -90.0 to +90.0 (North is positive) inclusive. It will also be ignored if there isn't a corresponding long parameter.
- long (number )
  The longitude to search around. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This parameter will be ignored if outside that range, if it is not a number, if geo_enabled is disabled, or if there not a corresponding lat parameter.
- name (string )
  The name a place is known as.
- contained_within (string )
  This is the place_id which you would like to restrict the search results to. Setting this value means only places within the given place_id will be found. Specify a place_id. For example, to scope all results to places within "San Francisco, CA USA", you would specify a place_id of "5a110d312052166f"
- ? "attribute:street_address" (string )
  This parameter searches for places which have this given street address. There are other well-known, and application specific attributes available. Custom attributes are also permitted. Learn more about Place Attributes.
- callback (string )
  If supplied, the response will use the JSONP format with a callback of the given name.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "query": { "params": { "accuracy": 0, "coordinates": { "coordinates": [ -122.42284884, 37.76893497 ], "type": "Point" }, "granularity": "neighborhood" }, "type": "reverse_geocode", "url": "https://api.twitter.com/1.1/geo/reverse_geocode.json?accuracy=0&granularity=neighborhood&lat=37.76893497&long=-122.42284884" }, "result": { "places": [ { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -122.42676492, 37.75983003 ], [ -122.420736, 37.75983003 ], [ -122.420736, 37.77226299 ], [ -122.42676492, 37.77226299 ] ] ], "type": "Polygon" }, "contained_within": [ { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -122.51368188, 37.70813196 ], [ -122.35845384, 37.70813196 ], [ -122.35845384, 37.83245301 ], [ -122.51368188, 37.83245301 ] ] ], "type": "Polygon" }, "country": "United States", "country_code": "US", "full_name": "San Francisco, CA", "id": "5a110d312052166f", "name": "San Francisco", "place_type": "city", "url": "https://api.twitter.com/1.1/geo/id/5a110d312052166f.json" } ], "country": "United States", "country_code": "US", "full_name": "Mission Dolores, San Francisco", "id": "cf7afb4ee6011bca", "name": "Mission Dolores", "place_type": "neighborhood", "url": "https://api.twitter.com/1.1/geo/id/cf7afb4ee6011bca.json" }, { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -122.51368188, 37.70813196 ], [ -122.35845384, 37.70813196 ], [ -122.35845384, 37.83245301 ], [ -122.51368188, 37.83245301 ] ] ], "type": "Polygon" }, "contained_within": [ { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -124.482003, 32.528832 ], [ -114.131211, 32.528832 ], [ -114.131211, 42.009517 ], [ -124.482003, 42.009517 ] ] ], "type": "Polygon" }, "country": "United States", "country_code": "US", "full_name": "California, US", "id": "fbd6d2f5a4e4a15e", "name": "California", "place_type": "admin", "url": "https://api.twitter.com/1.1/geo/id/fbd6d2f5a4e4a15e.json" } ], "country": "United States", "country_code": "US", "full_name": "San Francisco, CA", "id": "5a110d312052166f", "name": "San Francisco", "place_type": "city", "url": "https://api.twitter.com/1.1/geo/id/5a110d312052166f.json" }, { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -124.482003, 32.528832 ], [ -114.131211, 32.528832 ], [ -114.131211, 42.009517 ], [ -124.482003, 42.009517 ] ] ], "type": "Polygon" }, "contained_within": [ { "attributes": {}, "bounding_box": null, "country": "United States", "country_code": "US", "full_name": "United States", "id": "96683cc9126741d1", "name": "United States", "place_type": "country", "url": "https://api.twitter.com/1.1/geo/id/96683cc9126741d1.json" } ], "country": "United States", "country_code": "US", "full_name": "California, US", "id": "fbd6d2f5a4e4a15e", "name": "California", "place_type": "admin", "url": "https://api.twitter.com/1.1/geo/id/fbd6d2f5a4e4a15e.json" }, { "attributes": {}, "bounding_box": null, "contained_within": [], "country": "United States", "country_code": "US", "full_name": "United States", "id": "96683cc9126741d1", "name": "United States", "place_type": "country", "url": "https://api.twitter.com/1.1/geo/id/96683cc9126741d1.json" } ] } }

  ###### Schema

  { "type": "object", "$schema": "http://json-schema.org/draft-03/schema", "properties": { "attributes": { "type": "object", "properties": { "162834:id": { "type": "string" } } }, "bounding_box": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "contained_within": { "type": "array", "items": { "type": "object", "properties": { "attributes": { "type": "object" }, "bounding_box": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "country_code": { "type": "string" }, "country": { "type": "string" }, "full_name": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "place_type": { "type": "string" }, "url": { "type": "string" } } } }, "country_code": { "type": "string" }, "country": { "type": "string" }, "full_name": { "type": "string" }, "geometry": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "id": { "type": "string" }, "name": { "type": "string" }, "place_type": { "type": "string" }, "polylines": { "type": "array", "items": { "type": "string" } }, "url": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /geo/place{mediaTypeExtension}
POST

#### geo place{mediaTypeExtension}

POST
/geo/place{mediaTypeExtension}
Description
Creates a new place object at the given latitude and longitude. Before creating a place you need to query GET geo/similar_places with the latitude, longitude and name of the place you wish to create. The query will return an array of places which are similar to the one you wish to create, and a token. If the place you wish to create isn't in the returned array you can use the token with this method to create a new one.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- Content-Type: application/x-www-form-urlencoded

- ##### Body

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "query": { "params": { "accuracy": 0, "coordinates": { "coordinates": [ -122.42284884, 37.76893497 ], "type": "Point" }, "granularity": "neighborhood" }, "type": "reverse_geocode", "url": "https://api.twitter.com/1.1/geo/reverse_geocode.json?accuracy=0&granularity=neighborhood&lat=37.76893497&long=-122.42284884" }, "result": { "places": [ { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -122.42676492, 37.75983003 ], [ -122.420736, 37.75983003 ], [ -122.420736, 37.77226299 ], [ -122.42676492, 37.77226299 ] ] ], "type": "Polygon" }, "contained_within": [ { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -122.51368188, 37.70813196 ], [ -122.35845384, 37.70813196 ], [ -122.35845384, 37.83245301 ], [ -122.51368188, 37.83245301 ] ] ], "type": "Polygon" }, "country": "United States", "country_code": "US", "full_name": "San Francisco, CA", "id": "5a110d312052166f", "name": "San Francisco", "place_type": "city", "url": "https://api.twitter.com/1.1/geo/id/5a110d312052166f.json" } ], "country": "United States", "country_code": "US", "full_name": "Mission Dolores, San Francisco", "id": "cf7afb4ee6011bca", "name": "Mission Dolores", "place_type": "neighborhood", "url": "https://api.twitter.com/1.1/geo/id/cf7afb4ee6011bca.json" }, { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -122.51368188, 37.70813196 ], [ -122.35845384, 37.70813196 ], [ -122.35845384, 37.83245301 ], [ -122.51368188, 37.83245301 ] ] ], "type": "Polygon" }, "contained_within": [ { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -124.482003, 32.528832 ], [ -114.131211, 32.528832 ], [ -114.131211, 42.009517 ], [ -124.482003, 42.009517 ] ] ], "type": "Polygon" }, "country": "United States", "country_code": "US", "full_name": "California, US", "id": "fbd6d2f5a4e4a15e", "name": "California", "place_type": "admin", "url": "https://api.twitter.com/1.1/geo/id/fbd6d2f5a4e4a15e.json" } ], "country": "United States", "country_code": "US", "full_name": "San Francisco, CA", "id": "5a110d312052166f", "name": "San Francisco", "place_type": "city", "url": "https://api.twitter.com/1.1/geo/id/5a110d312052166f.json" }, { "attributes": {}, "bounding_box": { "coordinates": [ [ [ -124.482003, 32.528832 ], [ -114.131211, 32.528832 ], [ -114.131211, 42.009517 ], [ -124.482003, 42.009517 ] ] ], "type": "Polygon" }, "contained_within": [ { "attributes": {}, "bounding_box": null, "country": "United States", "country_code": "US", "full_name": "United States", "id": "96683cc9126741d1", "name": "United States", "place_type": "country", "url": "https://api.twitter.com/1.1/geo/id/96683cc9126741d1.json" } ], "country": "United States", "country_code": "US", "full_name": "California, US", "id": "fbd6d2f5a4e4a15e", "name": "California", "place_type": "admin", "url": "https://api.twitter.com/1.1/geo/id/fbd6d2f5a4e4a15e.json" }, { "attributes": {}, "bounding_box": null, "contained_within": [], "country": "United States", "country_code": "US", "full_name": "United States", "id": "96683cc9126741d1", "name": "United States", "place_type": "country", "url": "https://api.twitter.com/1.1/geo/id/96683cc9126741d1.json" } ] } }

  ###### Schema

  { "type": "object", "$schema": "http://json-schema.org/draft-03/schema", "properties": { "attributes": { "type": "object", "properties": { "162834:id": { "type": "string" } } }, "bounding_box": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "contained_within": { "type": "array", "items": { "type": "object", "properties": { "attributes": { "type": "object" }, "bounding_box": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "country_code": { "type": "string" }, "country": { "type": "string" }, "full_name": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "place_type": { "type": "string" }, "url": { "type": "string" } } } }, "country_code": { "type": "string" }, "country": { "type": "string" }, "full_name": { "type": "string" }, "geometry": { "type": "object", "properties": { "coordinates": { "type": "array", "items": { "type": "array" } }, "type": { "type": "string" } } }, "id": { "type": "string" }, "name": { "type": "string" }, "place_type": { "type": "string" }, "polylines": { "type": "array", "items": { "type": "string" } }, "url": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /trends

#### trends

URl: /trends/place{mediaTypeExtension}
GET

#### trends place{mediaTypeExtension}

GET
/trends/place{mediaTypeExtension}
Description
Returns the top 10 trending topics for a specific WOEID, if trending information is available for it. The response is an array of "trend" objects that encode the name of the trending topic, the query parameter that can be used to search for the topic on Twitter Search, and the Twitter Search URL. This information is cached for 5 minutes. Requesting more frequently than that will not return any more data, and will count against your rate limit usage.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- id (integer )
  The Yahoo! Where On Earth ID of the location to return trending information for. Global information is available by using 1 as the WOEID.
- exclude (string )
  Setting this equal to hashtags will remove all hashtags from the trends list.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "as_of": "2012-08-24T23:25:43Z", "created_at": "2012-08-24T23:24:14Z", "locations": [ { "name": "Worldwide", "woeid": 1 } ], "trends": [ { "events": null, "name": "#GanaPuntosSi", "promoted_content": null, "query": "%23GanaPuntosSi", "url": "http://twitter.com/search/?q=%23GanaPuntosSi" }, { "events": null, "name": "#WordsThatDescribeMe", "promoted_content": null, "query": "%23WordsThatDescribeMe", "url": "http://twitter.com/search/?q=%23WordsThatDescribeMe" }, { "events": null, "name": "#10PersonasQueExtra\u00f1oMucho", "promoted_content": null, "query": "%2310PersonasQueExtra%C3%B1oMucho", "url": "http://twitter.com/search/?q=%2310PersonasQueExtra%C3%B1oMucho" }, { "events": null, "name": "Apple $1.5", "promoted_content": null, "query": "%22Apple%20$1.5%22", "url": "http://twitter.com/search/?q=%22Apple%20$1.5%22" }, { "events": null, "name": "Zelko", "promoted_content": null, "query": "Zelko", "url": "http://twitter.com/search/?q=Zelko" }, { "events": null, "name": "LWWY", "promoted_content": null, "query": "LWWY", "url": "http://twitter.com/search/?q=LWWY" }, { "events": null, "name": "Lance Armstrong", "promoted_content": null, "query": "%22Lance%20Armstrong%22", "url": "http://twitter.com/search/?q=%22Lance%20Armstrong%22" }, { "events": null, "name": "Gonzo", "promoted_content": null, "query": "Gonzo", "url": "http://twitter.com/search/?q=Gonzo" }, { "events": null, "name": "Premium Rush", "promoted_content": null, "query": "%22Premium%20Rush%22", "url": "http://twitter.com/search/?q=%22Premium%20Rush%22" }, { "events": null, "name": "Sweet Dreams", "promoted_content": null, "query": "%22Sweet%20Dreams%22", "url": "http://twitter.com/search/?q=%22Sweet%20Dreams%22" } ] } ]

  ###### Schema

  { "type": "object", "$schema": "http://json-schema.org/draft-03/schema", "properties": { "_empty_": { "type": "object", "properties": { "as_of": { "type": "string" }, "created_at": { "type": "string" }, "locations": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "woeid": { "type": "number" } } } }, "trends": { "type": "array", "items": { "type": "object", "properties": { "events": { "type": "null" }, "name": { "type": "string" }, "promoted_content": { "type": "null" }, "query": { "type": "string" }, "url": { "type": "string" } } } } } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /trends/available{mediaTypeExtension}
GET

#### trends available{mediaTypeExtension}

GET
/trends/available{mediaTypeExtension}
Description
Returns the locations that Twitter has trending topic information for. The response is an array of "locations" that encode the location's WOEID and some other human-readable information such as a canonical name and country the location belongs in. A WOEID is a Yahoo! Where On Earth ID.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "country": "Sweden", "countryCode": "SE", "name": "Sweden", "parentid": 1, "placeType": { "code": 12, "name": "Country" }, "url": "http://where.yahooapis.com/v1/place/23424954", "woeid": 23424954 }, { "country": "United States", "countryCode": "US", "name": "New Haven", "parentid": 23424977, "placeType": { "code": 7, "name": "Town" }, "url": "http://where.yahooapis.com/v1/place/2458410", "woeid": 2458410 }, { "country": "Japan", "countryCode": "JP", "name": "Sapporo", "parentid": 23424856, "placeType": { "code": 7, "name": "Town" }, "url": "http://where.yahooapis.com/v1/place/1118108", "woeid": 1118108 }, { "country": "United States", "countryCode": "US", "name": "Providence", "parentid": 23424977, "placeType": { "code": 7, "name": "Town" }, "url": "http://where.yahooapis.com/v1/place/2477058", "woeid": 2477058 }, { "country": "United States", "countryCode": "US", "name": "Cincinnati", "parentid": 23424977, "placeType": { "code": 7, "name": "Town" }, "url": "http://where.yahooapis.com/v1/place/2380358", "woeid": 2380358 } ]

  ###### Schema

  { "type": "object", "$schema": "http://json-schema.org/draft-03/schema", "properties": { "_empty_": { "type": "object", "properties": { "countryCode": { "type": "string" }, "country": { "type": "string" }, "name": { "type": "string" }, "parentid": { "type": "number" }, "placeType": { "type": "object", "properties": { "code": { "type": "number" }, "name": { "type": "string" } } }, "url": { "type": "string" }, "woeid": { "type": "number" } } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /trends/closest{mediaTypeExtension}
GET

#### trends closest{mediaTypeExtension}

GET
/trends/closest{mediaTypeExtension}
Description
Returns the locations that Twitter has trending topic information for, closest to a specified location. The response is an array of "locations" that encode the location's WOEID and some other human-readable information such as a canonical name and country the location belongs in. A WOEID is a Yahoo! Where On Earth ID.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- lat (number )
  The latitude to search around. This parameter will be ignored unless it is inside the range -90.0 to +90.0 (North is positive) inclusive. It will also be ignored if there isn't a corresponding long parameter.
- long (number )
  The longitude to search around. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This parameter will be ignored if outside that range, if it is not a number, if geo_enabled is disabled, or if there not a corresponding lat parameter.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "country": "Sweden", "countryCode": "SE", "name": "Sweden", "parentid": 1, "placeType": { "code": 12, "name": "Country" }, "url": "http://where.yahooapis.com/v1/place/23424954", "woeid": 23424954 }, { "country": "United States", "countryCode": "US", "name": "New Haven", "parentid": 23424977, "placeType": { "code": 7, "name": "Town" }, "url": "http://where.yahooapis.com/v1/place/2458410", "woeid": 2458410 }, { "country": "Japan", "countryCode": "JP", "name": "Sapporo", "parentid": 23424856, "placeType": { "code": 7, "name": "Town" }, "url": "http://where.yahooapis.com/v1/place/1118108", "woeid": 1118108 }, { "country": "United States", "countryCode": "US", "name": "Providence", "parentid": 23424977, "placeType": { "code": 7, "name": "Town" }, "url": "http://where.yahooapis.com/v1/place/2477058", "woeid": 2477058 }, { "country": "United States", "countryCode": "US", "name": "Cincinnati", "parentid": 23424977, "placeType": { "code": 7, "name": "Town" }, "url": "http://where.yahooapis.com/v1/place/2380358", "woeid": 2380358 } ]

  ###### Schema

  { "type": "object", "$schema": "http://json-schema.org/draft-03/schema", "properties": { "_empty_": { "type": "object", "properties": { "countryCode": { "type": "string" }, "country": { "type": "string" }, "name": { "type": "string" }, "parentid": { "type": "number" }, "placeType": { "type": "object", "properties": { "code": { "type": "number" }, "name": { "type": "string" } } }, "url": { "type": "string" }, "woeid": { "type": "number" } } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /help

#### help

URl: /help/configuration{mediaTypeExtension}
GET

#### help configuration{mediaTypeExtension}

GET
/help/configuration{mediaTypeExtension}
Description
Returns the current configuration used by Twitter including twitter.com slugs which are not usernames, maximum photo resolutions, and t.co URL lengths. It is recommended applications request this endpoint when they are loaded, but no more than once a day.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "characters_reserved_per_media": 23, "max_media_per_upload": 1, "non_username_paths": [ "about", "account", "accounts", "activity", "all", "announcements", "anywhere", "api_rules", "api_terms", "apirules", "apps", "auth", "badges", "blog", "business", "buttons", "contacts", "devices", "direct_messages", "download", "downloads", "edit_announcements", "faq", "favorites", "find_sources", "find_users", "followers", "following", "friend_request", "friendrequest", "friends", "goodies", "help", "home", "im_account", "inbox", "invitations", "invite", "jobs", "list", "login", "logo", "logout", "me", "mentions", "messages", "mockview", "newtwitter", "notifications", "nudge", "oauth", "phoenix_search", "positions", "privacy", "public_timeline", "related_tweets", "replies", "retweeted_of_mine", "retweets", "retweets_by_others", "rules", "saved_searches", "search", "sent", "settings", "share", "signup", "signin", "similar_to", "statistics", "terms", "tos", "translate", "trends", "tweetbutton", "twttr", "update_discoverability", "users", "welcome", "who_to_follow", "widgets", "zendesk_auth", "media_signup" ], "photo_size_limit": 3145728, "photo_sizes": { "large": { "w": 1024, "resize": "fit", "h": 2048 }, "medium": { "w": 600, "resize": "fit", "h": 1200 }, "small": { "w": 340, "resize": "fit", "h": 480 }, "thumb": { "w": 150, "resize": "crop", "h": 150 } }, "short_url_length_https": 23, "short_url_length": 22 }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "characters_reserved_per_media": { "type": "integer" }, "max_media_per_upload": { "type": "integer" }, "non_username_paths": { "0": { "type": "string" } }, "type": "array", "photo_size_limit": { "type": "integer" }, "photo_sizes": { "large": { "w": { "type": "integer" }, "resize": "fit", "h": { "type": "integer" } }, "medium": { "w": { "type": "integer" }, "resize": "fit", "h": { "type": "integer" } }, "small": { "w": { "type": "integer" }, "resize": "fit", "h": { "type": "integer" } }, "thumb": { "w": { "type": "integer" }, "resize": "crop", "h": { "type": "integer" } } }, "short_url_length_https": { "type": "integer" }, "short_url_length": { "type": "integer" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /help/languages{mediaTypeExtension}
GET

#### help languages{mediaTypeExtension}

GET
/help/languages{mediaTypeExtension}
Description
Returns the list of languages supported by Twitter along with their ISO 639-1 code. The ISO 639-1 code is the two letter value to use if you include lang with any of your requests.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  [ { "name": "Fransk", "code": "fr", "status": "production" }, { "name": "Engelsk", "code": "en", "status": "production" }, { "name": "Arabisk", "code": "ar", "status": "production" }, { "name": "Japansk", "code": "ja", "status": "production" }, { "name": "Spansk", "code": "es", "status": "production" }, { "name": "Tysk", "code": "de", "status": "production" }, { "name": "Italiensk", "code": "it", "status": "production" }, { "name": "Indonesisk", "code": "id", "status": "production" }, { "name": "Portugisisk", "code": "pt", "status": "production" }, { "name": "Koreansk", "code": "ko", "status": "production" }, { "name": "Tyrkisk", "code": "tr", "status": "production" }, { "name": "Russisk", "code": "ru", "status": "production" }, { "name": "Nederlandsk", "code": "nl", "status": "production" }, { "name": "Filippinsk", "code": "fil", "status": "production" }, { "name": "Malayisk", "code": "msa", "status": "production" }, { "name": "Tradisjonell kinesisk", "code": "zh-tw", "status": "production" }, { "name": "Forenklet kinesisk", "code": "zh-cn", "status": "production" }, { "name": "Hindi", "code": "hi", "status": "production" }, { "name": "Norsk", "code": "no", "status": "production" }, { "name": "Svensk", "code": "sv", "status": "production" }, { "name": "Finsk", "code": "fi", "status": "production" }, { "name": "Dansk", "code": "da", "status": "production" }, { "name": "Polsk", "code": "pl", "status": "production" }, { "name": "Ungarsk", "code": "hu", "status": "production" }, { "name": "Farsi", "code": "fa", "status": "production" }, { "name": "Hebraisk", "code": "he", "status": "production" }, { "name": "Urdu", "code": "ur", "status": "production" }, { "name": "Thailandsk", "code": "th", "status": "production" } ]

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "_empty_": { "0": { "name": { "type": "string" }, "code": { "type": "string" }, "status": { "type": "string" } } }, "type": "array" } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /help/privacy{mediaTypeExtension}
GET

#### help privacy{mediaTypeExtension}

GET
/help/privacy{mediaTypeExtension}
Description
Returns Twitter's Privacy Policy.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "privacy": "Twitter Privacy Policy\n\nTwitter instantly connects people everywhere to what\u2019s most meaningful to them. Any registered user can send a Tweet, which is a message of 140 characters or less that is public by default and can include other content like photos, videos, and links to other websites.\n\n\n .... If we make a change to this policy that, in our sole discretion, is material, we will notify you via an @Twitter update or email to the email address associated with your account. By continuing to access or use the Services after those changes become effective, you agree to be bound by the revised Privacy Policy.\n\nEffective: May 17, 2012\n\nArchive of Previous Privacy Policies\n\nThoughts or questions about this Privacy Policy? Please, let us know." }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "privacy": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /help/tos{mediaTypeExtension}
GET

#### help tos{mediaTypeExtension}

GET
/help/tos{mediaTypeExtension}
Description
Returns the Twitter Terms of Service in the requested format. These are not the same as the Developer Rules of the Road.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "privacy": "Terms of Service\n\n\nThese Terms of Service (\"Terms\") govern your access to and use of the services, including our various websites, SMS, APIs, email notifications, applications, buttons, and widgets, (the \"Services\" or \u201cTwitter\u201d), and any information, text, graphics, photos or other materials uploaded, downloaded or appearing on the Services (collectively referred to as \"Content\"). Your access to and use of the Services are conditioned on your acceptance of and compliance with these Terms. ... \n\nThese Services are operated and provided by Twitter Inc., 1355 Market Street, Suite 900, San Francisco, CA 94103. If you have any questions about these Terms, please contact us.\n\nEffective: June 25, 2012\n\nArchive of Previous Terms" }

  ###### Schema

  { "_empty_": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "tos": { "type": "string" } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.

URl: /application/rate_limit_status{mediaTypeExtension}
GET

#### application rate_limit_status{mediaTypeExtension}

GET
/application/rate_limit_status{mediaTypeExtension}
Description
Returns the current rate limits for methods belonging to the specified resource families. Each 1.1 API resource belongs to a "resource family" which is indicated in its method documentation. You can typically determine a method's resource family from the first component of the path after the resource version. This method responds with a map of methods belonging to the families specified by the resources parameter, the current remaining uses for each of those resources within the current rate limiting window, and its expiration time in epoch time. It also includes a rate_limit_context field that indicates the current access token or application-only authentication context. You may also issue requests to this method without any parameters to receive a map of all rate limited GET methods. If your application only uses a few of methods, please explicitly provide a resources parameter with the specified resource families you work with. When using app-only auth, this method's response indicates the app-only auth rate limiting context. Read more about REST API Rate Limiting in v1.1 and review the limits.

#### Request

##### Uri Parameters

- mediaTypeExtension (string )
  Use .json to specify application/json media type.

##### Query parameters

- resources (string )
  A comma-separated list of resource families you want to know the current rate limit disposition for. For best performance, only specify the resource families pertinent to your application. See Rate Limiting in API v1.1 for more information.

  ###### Example

      statuses,friends,trends,help

- #### Response

- ##### Http Status code
  200

  Success!
- Content-Type: application/json

- ###### Example

  { "rate_limit_context": { "access_token": "119476949-oYGCs2M5duG5QalbOAK2YUZh8zG3ur7DPYo5qIFN" }, "resources": { "help": { "/help/privacy": { "remaining": 15, "reset": 1346439527, "limit": 15 }, "/help/configuration": { "remaining": 15, "reset": 1346439527, "limit": 15 }, "/help/tos": { "remaining": 15, "reset": 1346439527, "limit": 15 }, "/help/languages": { "remaining": 15, "reset": 1346439527, "limit": 15 } }, "statuses": { "/statuses/oembed": { "remaining": 180, "reset": 1346439527, "limit": 180 }, "/statuses/user_timeline": { "remaining": 180, "reset": 1346439527, "limit": 180 }, "/statuses/mentions_timeline": { "remaining": 15, "reset": 1346439527, "limit": 15 }, "/statuses/home_timeline": { "remaining": 15, "reset": 1346439527, "limit": 15 }, "/statuses/show/:id": { "remaining": 180, "reset": 1346439527, "limit": 180 }, "/statuses/retweets/:id": { "remaining": 15, "reset": 1346439527, "limit": 15 } }, "users": { "/users/show": { "remaining": 180, "reset": 1346439527, "limit": 180 }, "/users/search": { "remaining": 180, "reset": 1346439527, "limit": 180 }, "/users/suggestions": { "remaining": 15, "reset": 1346439527, "limit": 15 }, "/users/contributors": { "remaining": 15, "reset": 1346439527, "limit": 15 }, "/users/suggestions/:slug/members": { "remaining": 15, "reset": 1346439527, "limit": 15 }, "/users/suggestions/:slug": { "remaining": 15, "reset": 1346439527, "limit": 15 }, "/users/contributees": { "remaining": 15, "reset": 1346439527, "limit": 15 }, "/users/lookup": { "remaining": 180, "reset": 1346439527, "limit": 180 } }, "search": { "/search/tweets": { "remaining": 180, "reset": 1346439527, "limit": 180 } } } }

  ###### Schema

  { "type": "object", "$schema": "http://json-schema.org/draft-03/schema", "properties": { "rate_limit_context": { "type": "object", "properties": { "access_token": { "type": "string" } } }, "resources": { "type": "object", "properties": { "help": { "type": "object", "properties": { "/help/configuration": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/help/languages": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/help/privacy": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/help/tos": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } } } }, "search": { "type": "object", "properties": { "/search/tweets": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } } } }, "statuses": { "type": "object", "properties": { "/statuses/home_timeline": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/statuses/mentions_timeline": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/statuses/oembed": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/statuses/retweets/:id": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/statuses/show/:id": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/statuses/user_timeline": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } } } }, "users": { "type": "object", "properties": { "/users/contributees": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/users/contributors": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/users/lookup": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/users/search": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/users/show": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/users/suggestions/:slug/members": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/users/suggestions/:slug": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } }, "/users/suggestions": { "type": "object", "properties": { "limit": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } } } } } } } }

- ##### Http Status code
  304

  There was no new data to return.

- ##### Http Status code
  400

  The request was invalid or cannot be otherwise served. An accompanying error message will explain further. In API v1.1, requests without authentication are considered invalid and will yield this response.

- ##### Http Status code
  401

  Authentication credentials were missing or incorrect.

- ##### Http Status code
  403

  The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to update limits.

- ##### Http Status code
  404

  The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

- ##### Http Status code
  406

  Returned by the Search API when an invalid format is specified in the request.

- ##### Http Status code
  410

  This resource is gone. Used to indicate that an API endpoint has been turned off. For example: "The Twitter REST API v1 will soon stop functioning. Please migrate to API v1.1."

- ##### Http Status code
  420

  Returned by the version 1 Search and Trends APIs when you are being rate limited.

- ##### Http Status code
  422

  Returned when an image uploaded to POST account/update_profile_banner is unable to be processed.

- ##### Http Status code
  429

  Returned in API v1.1 when a request cannot be served due to the application's rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

- ##### Http Status code
  500

  Something is broken. Please post to the group so the Twitter team can investigate.

- ##### Http Status code
  502

  Twitter is down or being upgraded.

- ##### Http Status code
  503

  The Twitter servers are up, but overloaded with requests. Try again later.

- ##### Http Status code
  504

  The Twitter servers are up, but the request couldn't be serviced due to some failure within our stack. Try again later.