Skip to main content
GET
/
x
/
accounts
/
{id}
Get X account
curl --request GET \
  --url https://xquik.com/api/v1/x/accounts/{id} \
  --header 'x-api-key: <api-key>'

Documentation Index

Fetch the complete documentation index at: https://docs.xquik.com/llms.txt

Use this file to discover all available pages before exploring further.

Free - does not consume credits
Use this endpoint before a workflow acts with one connected account. Read health first: write with healthy, let recovering retry on next use, wait or bulk retry temporaryIssue, re-authenticate needsReauth, and fix locked or suspended on X before retrying writes.

​
Read the account state

Ready for actions

health: "healthy" means the stored session is usable. cookiesObtainedAt shows when the session was last obtained and is omitted if the account has not authenticated yet.

Needs credentials

health: "needsReauth" means credentials, TOTP, email verification, passkey, or another security challenge blocked login. Use Re-authenticate with current credentials and a valid TOTP secret before retrying writes.

Temporary recovery

health: "temporaryIssue" means a transient or automated cooldown is still active. Wait for recovery, or use Bulk retry for temporary failures. health: "recovering" means Xquik will retry automatically on the next account use.

X restriction

health: "locked" or health: "suspended" means writes stay blocked until the account is fixed on X. Re-authenticate or reconnect only after the account is usable again.

Region fields

proxyCountry is the selected login region stored on the account. The separate loginCountry field appears only in connect or re-authenticate responses when the actual login region differs.
curl -X GET https://xquik.com/api/v1/x/accounts/3 \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

​
Path parameters

​
id
string
required
The unique account ID. Returned when you connect an account or list accounts.

​
Headers

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

​
Response

​
id
string
Unique account ID.
​
xUsername
string
X username.
​
xUserId
string
X user ID.
​
status
string
Account connection status (e.g. "active").
​
health
string
Derived login/cookie health. One of healthy, locked, needsReauth, recovering, suspended, temporaryIssue. See Account health for meanings.
​
proxyCountry
string
Proxy region used for the connection (e.g. "US").
​
cookiesObtainedAt
string
ISO 8601 timestamp of when session cookies were last obtained. Omitted if not yet authenticated.
​
createdAt
string
ISO 8601 timestamp of when the account was connected.
​
updatedAt
string
ISO 8601 timestamp of the last update.
{
  "id": "3",
  "xUsername": "elonmusk",
  "xUserId": "44196397",
  "status": "active",
  "health": "healthy",
  "proxyCountry": "US",
  "cookiesObtainedAt": "2026-02-20T08:15:00.000Z",
  "createdAt": "2026-02-20T08:15:00.000Z",
  "updatedAt": "2026-02-20T08:15:00.000Z"
}
Related: List X Accounts to see all accounts, Disconnect to remove this account, or Re-authenticate if the session has expired.
Last modified on May 24, 2026