Direct Messages Lookup

The Direct Messages lookup endpoints let you retrieve DM events for the authenticated user. Reference for the X API v2 standard tier covering lookup.

The Direct Messages lookup endpoints let you retrieve DM events for the authenticated user, including messages from both one-to-one and group conversations.

Overview

All DM events

Get all DM events for the user

One-to-one

Get events from a specific conversation

By conversation ID

Get events by conversation ID

Event types

Messages, joins, and leaves

---

Endpoints

Method	Endpoint	Description
GET	/2/dm_events	Get all DM events for the user
GET	/2/dm_conversations/with/:participant_id/dm_events	Get events from one-to-one conversation
GET	/2/dm_conversations/:dm_conversation_id/dm_events	Get events by conversation ID

---

Event types

Event	Description
MessageCreate	A message was sent in the conversation
ParticipantsJoin	A user joined the conversation
ParticipantsLeave	A user left the conversation

---

Data retention

Events from up to 30 days ago are available through these endpoints.

---

Getting started

Prerequisites

• An approved developer account
• A Project and App in the Developer Console
• User Access Tokens via 3-legged OAuth

Quickstart

Make your first DM lookup request

Integration guide

Key concepts and best practices

API Reference

Full endpoint documentation

Sample code

Working code examples