Check DM Permissions (V2)

Check DM status signals for user IDs or usernames. Accept either an object with users and an optional sender cookie, or the original string array. When cookie is supplied, both username resolution and permission queries use that sender session. Omitting cookie uses service-managed accounts. A supplied invalid session never falls back to those accounts.

cookie accepts the complete X Cookie header value or the raw auth_token. Empty strings, whitespace-only values, null, and non-string values return HTTP 422. Results retain 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.

With a sender session:

{"users":["44196397","elonmusk"],"cookie":"auth_token=YOUR_X_AUTH_TOKEN; ct0=YOUR_CT0"}

The original request remains supported:

["44196397","elonmusk"]

curl -X POST "https://api.twexapi.io/v2/dm/status" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "users": [
    "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({
  "users": [
    "44196397",
    "elonmusk"
  ]
})
});

import requests

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

{
  "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": {}
    }
  ]
}