Skip to main content
GET
/
x
/
accounts
List X accounts
curl --request GET \
  --url https://xquik.com/api/v1/x/accounts \
  --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
Check accounts[].health before scheduling writes. healthy can write now. recovering can retry automatically on the next account use. temporaryIssue is still paused by a transient cooldown. needsReauth requires fresh credentials, TOTP setup, or a resolved security challenge through Re-authenticate X Account. locked and suspended stay blocked until the account is fixed on X.
curl -X GET https://xquik.com/api/v1/x/accounts \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

​
Headers

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

​
Response

​
accounts
object[]
Array of connected X account objects.
​
accounts[].id
string
Unique account ID.
​
accounts[].xUsername
string
X username.
​
accounts[].xUserId
string
X user ID.
​
accounts[].status
string
Account connection status (e.g. "active").
​
accounts[].health
string
Derived login/cookie health. One of healthy, locked, needsReauth, recovering, suspended, temporaryIssue. See Account health below.
​
accounts[].proxyCountry
string
Proxy region used for the connection (e.g. "US").
​
accounts[].cookiesObtainedAt
string
ISO 8601 timestamp of when session cookies were last obtained. Omitted if not yet authenticated.
​
accounts[].createdAt
string
ISO 8601 timestamp of when the account was connected.
​
accounts[].updatedAt
string
ISO 8601 timestamp of the last update.
{
  "accounts": [
    {
      "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"
    },
    {
      "id": "5",
      "xUsername": "xquik_",
      "xUserId": "1234567890",
      "status": "active",
      "health": "healthy",
      "proxyCountry": "US",
      "cookiesObtainedAt": "2026-02-22T12:00:00.000Z",
      "createdAt": "2026-02-22T12:00:00.000Z",
      "updatedAt": "2026-02-22T12:00:00.000Z"
    }
  ]
}
Related: Connect X Account to add a new account, or Get X Account to fetch details for a specific account.

​
Account health

The health field is derived from recent login and cookie state. Use it before writes so your workflow proceeds, waits, retries automatically, or asks the operator to fix the account first.

healthy

Cookies are valid. Writes can proceed.

needsReauth

Credentials, TOTP, email verification, passkey, or another security challenge blocked login. Use reauth with current credentials and a valid TOTP secret before retrying writes.

locked

X locked the account or requires account-side verification. Complete the X check, then reauth or reconnect after the account works again.

suspended

X suspended the account. Appeal on X; writes and automatic retries stay paused until the account is restored.

recovering

Past a transient cooldown. Xquik will retry automatically on the next account use.

temporaryIssue

Transient or automated cooldown is still active. Wait for recovery, or use bulk retry for temporary failures.
Last modified on May 23, 2026