Lookup
Get recent DM Events
Returns recent DM Events across DM conversations
GET
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Query Parameters
The maximum number of results.
Required range:
1 <= x <= 100
This parameter is used to get a specified 'page' of results.
Minimum length:
16
The set of event_types to include in the results.
Available options:
MessageCreate
, ParticipantsJoin
, ParticipantsLeave
Example:
["MessageCreate", "ParticipantsLeave"]
A comma separated list of DmEvent fields to display.
Available options:
attachments
, created_at
, dm_conversation_id
, entities
, event_type
, id
, participant_ids
, referenced_tweets
, sender_id
, text
Example:
[
"attachments",
"created_at",
"dm_conversation_id",
"entities",
"event_type",
"id",
"participant_ids",
"referenced_tweets",
"sender_id",
"text"
]
A comma separated list of fields to expand.
Available options:
attachments.media_keys
, participant_ids
, referenced_tweets.id
, sender_id
Example:
[
"attachments.media_keys",
"participant_ids",
"referenced_tweets.id",
"sender_id"
]
A comma separated list of Media fields to display.
Available options:
alt_text
, duration_ms
, height
, media_key
, non_public_metrics
, organic_metrics
, preview_image_url
, promoted_metrics
, public_metrics
, type
, url
, variants
, width
Example:
[
"alt_text",
"duration_ms",
"height",
"media_key",
"non_public_metrics",
"organic_metrics",
"preview_image_url",
"promoted_metrics",
"public_metrics",
"type",
"url",
"variants",
"width"
]
A comma separated list of User fields to display.
Available options:
affiliation
, confirmed_email
, connection_status
, created_at
, description
, entities
, id
, is_identity_verified
, location
, most_recent_tweet_id
, name
, parody
, pinned_tweet_id
, profile_banner_url
, profile_image_url
, protected
, public_metrics
, receives_your_dm
, subscription
, subscription_type
, url
, username
, verified
, verified_followers_count
, verified_type
, withheld
Example:
[
"affiliation",
"confirmed_email",
"connection_status",
"created_at",
"description",
"entities",
"id",
"is_identity_verified",
"location",
"most_recent_tweet_id",
"name",
"parody",
"pinned_tweet_id",
"profile_banner_url",
"profile_image_url",
"protected",
"public_metrics",
"receives_your_dm",
"subscription",
"subscription_type",
"url",
"username",
"verified",
"verified_followers_count",
"verified_type",
"withheld"
]
A comma separated list of Tweet fields to display.
Available options:
article
, attachments
, author_id
, card_uri
, community_id
, context_annotations
, conversation_id
, created_at
, display_text_range
, edit_controls
, edit_history_tweet_ids
, entities
, geo
, id
, in_reply_to_user_id
, lang
, media_metadata
, non_public_metrics
, note_tweet
, organic_metrics
, possibly_sensitive
, promoted_metrics
, public_metrics
, referenced_tweets
, reply_settings
, scopes
, source
, text
, withheld
Example:
[
"article",
"attachments",
"author_id",
"card_uri",
"community_id",
"context_annotations",
"conversation_id",
"created_at",
"display_text_range",
"edit_controls",
"edit_history_tweet_ids",
"entities",
"geo",
"id",
"in_reply_to_user_id",
"lang",
"media_metadata",
"non_public_metrics",
"note_tweet",
"organic_metrics",
"possibly_sensitive",
"promoted_metrics",
"public_metrics",
"referenced_tweets",
"reply_settings",
"scopes",
"source",
"text",
"withheld"
]
Response
200
application/json
The request has succeeded.
The response is of type object
.