GET account/verify_credentials

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 a User’s Email Address

Requesting a user’s email address requires your application to be whitelisted by Twitter. To request access, please use this form.

Once whitelisted, the “Request email addresses from users” checkbox will be available under your app permissions on Privacy Policy URL and Terms of Service URL fields will also be available under settings which are required for email access. If enabled, users will be informed via the oauth/authorize dialog that your app can access their email address.


Your app will need to regenerate the user access tokens for previously authenticated users to access their email address.

Resource URL

Resource Information

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


include_entities optional

The entities node will not be included when set to false.

Example Values: false

skip_status optional

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

Example Values: true

include_email optional

Use of this parameter requires whitelisting.

When set to true email will be returned in the user objects as a string. If the user does not have an email address on their account, or if the email address is un-verified, null will be returned.

Example Values: true

OAuth Signature Generator

Sign in to see a list of your registered applications.

Example Request


Example Result

    "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": "", 
    "profile_background_image_url_https": "", 
    "profile_background_tile": true, 
    "profile_image_url": "", 
    "profile_image_url_https": "", 
    "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": [
            "type": "Point"
        "created_at": "Tue Aug 28 05:44:24 +0000 2012", 
        "favorited": false, 
        "geo": {
            "coordinates": [
            "type": "Point"
        "id": 240323931419062272, 
        "id_str": "240323931419062272", 
        "in_reply_to_screen_name": "messl", 
        "in_reply_to_status_id": 240316959173009410, 
        "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": [
                "type": "Polygon"
            "country": "United States", 
            "country_code": "US", 
            "full_name": "Ashbury Heights, San Francisco", 
            "id": "866269c983527d5a", 
            "name": "Ashbury Heights", 
            "place_type": "neighborhood", 
            "url": ""
        "retweet_count": 0, 
        "retweeted": false, 
        "source": "Twitter for  iPhone", 
        "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