Check DM Permissions (V2)

Retrieves the Direct Message (DM) availability status for a list of users. This endpoint checks if the specified accounts can receive messages based on their privacy settings, follow status, or verified permissions.

Back to API Reference

/DM Endpoints

TwexAPI REST

POST/v2/dm/status

Authorization

AuthorizationBearer token · headerrequired

Global API Bearer Token for TwexAPI. Included as: Authorization: Bearer <YOUR_TWEXAPI_KEY>.

Request Body

requiredapplication/json

Array of string

string

Responses

200An object mapping user identifiers to their respective DM reachability status.

codeintegerrequired

The status code of the response.

msgstringrequired

The message of the response.

dataDMStatusModelV2[]required

A list of DM status objects.

Show properties

Array of DMStatusModelV2

user_idstring | any

The ID of the user.

Show properties

Any of:

string

string

any

any

screen_namestring | any

The username of the user.

Show properties

Any of:

string

string

any

any

is_blue_verifiedboolean | any

Show properties

Any of:

boolean

boolean

any

any

is_verified_organization_affiliateboolean | any

Show properties

Any of:

boolean

boolean

any

any

verifiedboolean | any

Show properties

Any of:

boolean

boolean

any

any

can_dmboolean | any

Show properties

Any of:

boolean

boolean

any

any

can_dm_on_xchatboolean | any

Show properties

Any of:

boolean

boolean

any

any

dm_blockingboolean | any

Show properties

Any of:

boolean

boolean

any

any

passes_premium_checkboolean | any

Show properties

Any of:

boolean

boolean

any

any

422Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

⚡Interactive Console / Try APIPOST/v2/dm/status

Live Console

🌐Target Server:https://api.twexapi.io

● Production Ready

🔍

Public Data Read (TwexAPI Key Only, No Twitter Cookie Required)

This endpoint queries public Twitter data — no Twitter account or Cookie required! Simply enter your TwexAPI Platform Key (Bearer Token) in the "API Authorization" section below to test.

🔑API Authorization

Remember keySync to code samples

TwexAPI Platform Key Bearer TokenRequired

Global API key used across all TwexAPI endpoints. Get it from the console.

📝Request Bodyapplication/json

💡 Quick send:⌘ / Ctrl+Enter

📡

No Response Yet

Configure parameters in the Request tab and click Send Request below.

Request

curl -X POST "https://api.twexapi.io/v2/dm/status" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
  "1696160451770429440",
  "elonmusk"
]'

const response = await fetch("https://api.twexapi.io/v2/dm/status", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify([
  "1696160451770429440",
  "elonmusk"
])
});

import requests

response = requests.post(
    "https://api.twexapi.io/v2/dm/status",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json=[
  "1696160451770429440",
  "elonmusk"
],
)

Response

{
  "code": 0,
  "msg": "string",
  "data": [
    {
      "user_id": "string",
      "screen_name": "string",
      "is_blue_verified": true,
      "is_verified_organization_affiliate": true,
      "verified": true,
      "can_dm": true,
      "can_dm_on_xchat": true,
      "dm_blocking": true,
      "passes_premium_check": true
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}