Skip to main content
GET
X Account Connection Status API & Login Challenges
Free - does not consume credits
Check this endpoint after the connect response’s Retry-After delay. Keep using Xquik while the connection continues. Do not send the credentials again while status is pending.

Headers

string
required
Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.

Path

string
required
Connection attempt ID from the 202 pending connect response.

Response

Every 200 response includes Cache-Control: no-store.

200 Pending

string
Always x_account_connection_attempt.
string
Connection attempt ID.
string
Always pending.
integer
Milliseconds to wait before checking again.
The response includes Retry-After: 3. Wait, then check the same attempt.

200 Success

string
Always x_account_connection_attempt.
string
Connection attempt ID.
string
Always success.
The account is ready. Call List X Accounts if you need its account ID.

200 Email Code Required

string
Always x_account_connection_challenge.
string
Challenge ID, not the attempt ID.
string
Always requires_email_code.
string
ISO 8601 challenge expiration time.
string
Human-readable next step.
string
X username being connected.
Submit the newest code to Submit X Account Email Code.

200 Failed

string
Always x_account_connection_attempt.
string
Connection attempt ID.
string
Always failed.
string
Stable public error code.
string
More specific reason when available.
boolean
Whether another connect request can be attempted.
Stop checking this attempt. Start a new connection only when appropriate.

400 Invalid Input

The attempt ID is malformed, unavailable, or belongs to another account. Do not rely on indefinite attempt retention. Save the terminal result.

401 Unauthenticated

The API key is missing or invalid.

429 Rate Limited

Wait for Retry-After before checking again.
Related: Connect X Account starts the attempt. Submit X Account Email Code completes an email challenge.