GET
/
2
/
dm_conversations
/
with
/
{participant_id}
/
dm_events

Authorizations

Authorization
string
headerrequired

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

participant_id
string
required

The ID of the participant user for the One to One DM conversation.

Query Parameters

max_results
integer
default: 100

The maximum number of results.

Required range: 1 < x < 100
pagination_token
string

This parameter is used to get a specified 'page' of results.

Minimum length: 16
event_types
enum<string>[]

The set of event_types to include in the results.

Available options:
MessageCreate,
ParticipantsJoin,
ParticipantsLeave
dm_event.fields
enum<string>[]

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
expansions
enum<string>[]

A comma separated list of fields to expand.

Available options:
attachments.media_keys,
participant_ids,
referenced_tweets.id,
sender_id
media.fields
enum<string>[]

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
user.fields
enum<string>[]

A comma separated list of User fields to display.

Available options:
affiliation,
connection_status,
created_at,
description,
entities,
id,
location,
most_recent_tweet_id,
name,
pinned_tweet_id,
profile_banner_url,
profile_image_url,
protected,
public_metrics,
receives_your_dm,
subscription_type,
url,
username,
verified,
verified_type,
withheld
tweet.fields
enum<string>[]

A comma separated list of Tweet fields to display.

Available options:
article,
attachments,
author_id,
card_uri,
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
data
object[]
errors
object[]
includes
object
meta
object
Send a new message to a DM ConversationGet DM Events for a DM Conversation