Check DM Permissions (V2)

Check DM status signals for user IDs or usernames. Send the targets as a JSON string array; queries use service-managed accounts.

["44196397","elonmusk"]

Results keep the existing fields and batch/credit limits. can_dm_on_xchat=false alone does not mean ordinary DMs are unavailable; the returned signals do not guarantee that sending will succeed.

Coming soon: an object body with users and an optional sender cookie ({"users":[...],"cookie":"..."}). It is not yet available on the live API and currently returns HTTP 422; use the array format above until it ships.

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

Any of:

string[]

Array of string

string

object

usersstring[]required

User IDs or usernames to check. Send numeric user IDs as strings.

cookiestring

Optional actual sender's authorized X Cookie header value or raw auth_token. Omit to use service-managed accounts. Blank, null, or non-string values are invalid; authentication failures never fall back to the account pool.

matches \S

Responses

200A list of user DM status and verification metadata.

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 '[
  "44196397",
  "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([
  "44196397",
  "elonmusk"
])
});

import requests

response = requests.post(
    "https://api.twexapi.io/v2/dm/status",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json=[
  "44196397",
  "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": {}
    }
  ]
}