GET direct_messages/show

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.

Resource URL

https://api.twitter.com/1.1/direct_messages/show.json

Resource Information

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

Parameters

Name Required Description Default Value Example
id required The ID of the direct message.   587424932

Example Request

GET https://api.twitter.com/1.1/direct_messages/show.json?id=240136858829479936

Example Response


[
    {
        "created_at": "Mon Aug 27 17:21:03 +0000 2012",
        "entities": {
            "hashtags": [],
            "urls": [],
            "user_mentions": []
        },
        "id": 240136858829479936,
        "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"
    }
]