GET account/verify_credentials

API version 1
Updated on Wed, 2012-04-18 11:29

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.

Resource URL

http://api.twitter.com/1/account/verify_credentials.format

Parameters

include_entities optional

When set to either true, t or 1, each tweet will include a node called "entities,". This node offers a variety of metadata about the tweet in a discreet structure, including: user_mentions, urls, and hashtags. While entities are opt-in on timelines at present, they will be made a default component of output in the future. See Tweet Entities for more detail on entities.

Example Values: true

skip_status optional

When set to either true, t or 1 statuses will not be included in the returned user objects.

Example Values: true

Example Request

GET

https://api.twitter.com/1/account/verify_credentials.json 

  1. {
  2.   "name": "Matt Harris",
  3.   "profile_sidebar_border_color": "C0DEED",
  4.   "profile_background_tile": false,
  5.   "profile_sidebar_fill_color": "DDEEF6",
  6.   "location": "San Francisco",
  7.   "profile_image_url": "http://a1.twimg.com/profile_images/554181350/matt_normal.jpg",
  8.   "created_at": "Sat Feb 17 20:49:54 +0000 2007",
  9.   "profile_link_color": "0084B4",
  10.   "favourites_count": 95,
  11.   "url": "http://themattharris.com",
  12.   "contributors_enabled": false,
  13.   "utc_offset": -28800,
  14.   "id": 777925,
  15.   "profile_use_background_image": true,
  16.   "profile_text_color": "333333",
  17.   "protected": false,
  18.   "followers_count": 1025,
  19.   "lang": "en",
  20.   "verified": false,
  21.   "profile_background_color": "C0DEED",
  22.   "geo_enabled": true,
  23.   "notifications": false,
  24.   "description": "Developer Advocate at Twitter. Also a hacker and British expat who is married to @cindyli and lives in San Francisco.",
  25.   "time_zone": "Tijuana",
  26.   "friends_count": 294,
  27.   "statuses_count": 2924,
  28.   "profile_background_image_url": "http://s.twimg.com/a/1276711174/images/themes/theme1/bg.png",
  29.   "status": {
  30.     "coordinates": {
  31.       "coordinates": [
  32.         -122.40075845,
  33.         37.78264991
  34.       ],
  35.       "type": "Point"
  36.     },
  37.     "favorited": false,
  38.     "created_at": "Tue Jun 22 18:17:48 +0000 2010",
  39.     "truncated": false,
  40.     "text": "Going through and updating @twitterapi documentation",
  41.     "contributors": null,
  42.     "id": 16789004997,
  43.     "geo": {
  44.       "coordinates": [
  45.         37.78264991,
  46.         -122.40075845
  47.       ],
  48.       "type": "Point"
  49.     },
  50.     "in_reply_to_user_id": null,
  51.     "place": null,
  52.     "source": "<a href=\"http://itunes.apple.com/app/twitter/id333903271?mt=8\" rel=\"nofollow\">Twitter for iPhone</a>",
  53.     "in_reply_to_screen_name": null,
  54.     "in_reply_to_status_id": null
  55.   },
  56.   "screen_name": "themattharris",
  57.   "following": false
  58. }