---
title: "Get Conversations (XChat v3)"
method: POST
path: "/v3/twitter/conversations"
tags: ["DM Endpoints"]
---

# Get Conversations (XChat v3)

`POST /v3/twitter/conversations`

## Request

- Base URL: `https://api.twexapi.io`
- URL: `https://api.twexapi.io/v3/twitter/conversations`
- Auth: HTTP bearer

Get XChat conversation list. Use count for page size (10–200). Set all=true to follow the inbox cursor and return every conversation.

## Request body

- GetConversationsV3Query: Parameters for getting XChat conversation list
  - `count` integer, nullable: Max conversations per page (10–200, default 20).
  - `all` boolean, nullable: Follow the inbox cursor and return every conversation (may be slow).
  - `cookie` string, required: The user's own authorized Twitter session credentials or auth_token (BYOC — Bring Your Own Cookie). Stateless proxy execution with zero credential retention. See [Authentication Security](/authentication#write-operations--byoc-bring-your-own-cookie) and [How to get Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).
  - `proxy` string, nullable: Optional HTTP proxy. Example: http://username:password@ip:port

## Response `200`

A list of conversation objects.

- GetConversationsV3Response: Response for getting XChat conversation list
  - `code` integer, required: Response code
  - `msg` string, required: Response message
  - `data` ConversationV3Model[], required: Conversation list
    - `conversation_id` string, required: Conversation id
    - `type` string, required: Conversation type: direct or group
    - `is_muted` boolean, required: Whether the conversation is muted
    - `participants` string[], required: Participant user ids

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/twexapi/apis/twexapi-rest-api.md) · [All operations](https://skmtc.dev/twexapi/apis/twexapi-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/twexapi/apis/twexapi-rest-api/revisions/59a99ac0d8f7?raw)