Sending and receiving events
API Reference contents
POST direct_messages/destroy (deprecated, sunset August 16th, 2018)
GET direct_messages/events/show
GET direct_messages/events/list
POST direct_messages/events/new (message_create)
GET direct_messages/show (deprecated, sunset August 16th, 2018)
GET direct_messages (deprecated, sunset August 16th, 2018)
GET direct_messages/sent (deprecated, sunset August 16th, 2018)
POST direct_messages/new (deprecated, sunset August 16th, 2018)
DELETE direct_messages/events/destroy
GET direct_messages/show (deprecated, sunset August 16th, 2018)¶
Important: This endpoint will be deprecated and non-functional on August 16, 2018. See the DM Migration Guide for further information.
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"
}
]