X Accounts
X Account Connection Status API & Login Challenges
Poll a tracked X account connection until it succeeds, fails, needs reauthentication, or requests an email verification code. Includes request fields.
- 200
- 400
- 401
- 429
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
Every200 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.
Retry-After: 3. Wait, then check the same attempt.
200 Success
string
Always
x_account_connection_attempt.string
Connection attempt ID.
string
Always
success.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.
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.
400 Invalid Input
401 Unauthenticated
429 Rate Limited
Retry-After before checking again.
Related: Connect X Account starts the
attempt. Submit X Account Email Code
completes an email challenge.
- 200
- 400
- 401
- 429
X Account Connection Status API & Login Challenges