Skip to main content
GET
List Conversations

Authorizations

Authorization
string
header
required

Your OmniX API key, e.g. omnix_live_.... Billed per call.

Query Parameters

auth_token
string
required

The X account auth_token cookie the action runs as.

encryption_code
string

Your XChat PIN. Provide it to include a preview of the most recent message in each conversation. Without it, you'll get the conversation details and participants, but no message preview.

count
integer
default:20

Page size (1–100).

cursor_id
string

From a previous response next_cursor.cursor_id — paginate to the next page of conversations.

graph_snapshot_id
string

From a previous response next_cursor.graph_snapshot_id — paired with cursor_id.

proxy
string

Optional outbound proxy for this call (http:// or https://, optionally user:pass@host:port). The X request runs through it — useful for geo-routing or spreading calls across IPs. SOCKS proxies are not supported.

Response

Conversation list.

status
boolean
Example:

true

data
object
error
string | null
Example:

null