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
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 to decide whether to attempt writes or trigger a reauth.

healthy

Cookies are valid. Writes can proceed.

needsReauth

Credentials were rejected. Submit fresh credentials via reauth.

locked

X locked the account. Unlock it at x.com/account/access, then reauth.

suspended

X banned the account. Appeal on X; writes will not recover automatically.

recovering

Past a transient cooldown. Xquik will auto-retry on next use.

temporaryIssue

Transient service problem. Retry shortly.
Last modified on May 11, 2026