Connected X accounts API, health & write readiness

{
  "accounts": [
    {
      "id": "42",
      "xUserId": "9876543210",
      "xUsername": "elonmusk",
      "status": "active",
      "health": "healthy"
    }
  ]
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

GET

accounts

Connected X accounts API, health & write readiness

curl --request GET \
  --url https://xquik.com/api/v1/x/accounts

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/accounts"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "accounts": [
    {}
  ],
  "accounts[].id": "<string>",
  "accounts[].xUsername": "<string>",
  "accounts[].xUserId": "<string>",
  "accounts[].status": "<string>",
  "accounts[].health": "<string>",
  "accounts[].cookiesObtainedAt": "<string>",
  "accounts[].createdAt": "<string>",
  "accounts[].updatedAt": "<string>"
}

Free. This endpoint does not consume credits.

List every X account connected to the authenticated Xquik account. Read each local connection ID, X username, X user ID, and login health before writes. This endpoint lists your Xquik connections. It does not search public Twitter accounts. Use Search Users for public profile search.

Check accounts[].health before scheduling writes. healthy can write now. recovering can reconnect on the next account use. temporaryIssue is still paused by a transient cooldown. needsReauth requires credentials, TOTP, or a completed security challenge. locked and suspended stay blocked until the account is fixed on X.

When to list connected X accounts

Workflow	Use the response for
Before a Tweet, reply, DM, like, follow, or profile update	Select `accounts[].id` and require acceptable health
After connecting an account	Confirm the new username and local connection ID
After reauthentication	Confirm that `health` changed before resuming writes
Before scheduled automation	Exclude blocked accounts and defer temporary cooldowns
During account support	Compare username, X user ID, timestamps, status, and health

Scope, ordering & pagination

The response contains only connections owned by the authenticated Xquik account. It returns every matching connection in one array. The endpoint accepts no query parameters. It does not paginate, search, or filter. Accounts are ordered by createdAt from earliest to latest. An Xquik account without connected X profiles receives {"accounts": []}. Connect one account before calling write endpoints.

curl -X GET https://xquik.com/api/v1/x/accounts \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

const response = await fetch("https://xquik.com/api/v1/x/accounts", {
  method: "GET",
  headers: {
    "x-api-key": "xq_YOUR_KEY_HERE",
  },
});
const data = await response.json();

import requests

response = requests.get(
    "https://xquik.com/api/v1/x/accounts",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
)
data = response.json()

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://xquik.com/api/v1/x/accounts", nil)
    if err != nil {
        panic(err)
    }
    req.Header.Set("x-api-key", "xq_YOUR_KEY_HERE")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var data map[string]interface{}
    if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
        panic(err)
    }
    fmt.Println(data)
}

Headers

Send an Xquik API key or OAuth 2.1 bearer token.

string

Xquik API key. Generate one from the dashboard.

string

OAuth bearer token using Bearer YOUR_TOKEN.

Response

200 OK

object[]

required

Account-scoped connected X profiles. Empty when no connection exists.

string

required

Xquik connection ID. Use it as accountId for write endpoints.

string

required

Connected X username without a leading @.

string

required

Stable X user ID as a string. This is not the Xquik connection ID.

string

required

Stored connection status. The documented response example uses active.

string

required

Derived login/cookie health. One of healthy, locked, needsReauth, recovering, suspended, or temporaryIssue. See Account Health below.

string

ISO 8601 time when the stored X session was obtained. Omitted before login.

string

required

ISO 8601 time when this Xquik connection was created.

string

required

ISO 8601 time when this connection row last changed.

{
  "accounts": [
    {
      "id": "3",
      "xUsername": "elonmusk",
      "xUserId": "44196397",
      "status": "active",
      "health": "healthy",
      "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",
      "cookiesObtainedAt": "2026-02-22T12:00:00.000Z",
      "createdAt": "2026-02-22T12:00:00.000Z",
      "updatedAt": "2026-02-22T12:00:00.000Z"
    }
  ]
}

Choose the correct account identifier

Field	Identifier scope	Use
`id`	Xquik connection	Pass as `accountId` for Tweets, replies, DMs, likes, follows, and profile writes
`xUserId`	X platform account	Compare X identities or correlate read responses
`xUsername`	Public X handle	Display the account and confirm operator intent

Do not send xUserId where a write endpoint requires accountId. Reconnecting after disconnection creates a new Xquik connection ID.

Preflight a write

List connected X accounts.
Match the intended xUsername or xUserId.
Read health before selecting the local id.
Continue immediately only when the account is ready.
Reauthenticate, wait, or retry according to the health table.

The status field alone is insufficient. An active connection can still need reauthentication or an X-side recovery.

401 Unauthenticated

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

Send a valid Xquik API key or OAuth bearer token.

429 Rate limited

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

Wait for the Retry-After value before listing accounts again.

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 connection state. Read it before writes. Your workflow can proceed, wait, or request an operator action.

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 stay paused until the account is restored.

recovering

The transient cooldown ended. The account can reconnect on its next use.

temporaryIssue

Transient or automated cooldown is still active. Wait for recovery, or use bulk retry for temporary failures.

Account health decisions

Health	Write readiness	Next action
`healthy`	Ready	Use `id` with the intended write endpoint
`recovering`	Retry on next use	Let the next account action reconnect
`temporaryIssue`	Wait	Respect the cooldown or clear eligible failures with Bulk Retry
`needsReauth`	Blocked	Send current credentials and the saved TOTP secret
`locked`	Blocked	Complete the required recovery on X, then reauthenticate
`suspended`	Blocked	Resolve the suspension on X before another Xquik write

Health is derived from recent connection state. It can change after a failed login, cooldown expiry, reauthentication, or X-side recovery.

Connected X account questions

Does this endpoint search Twitter accounts?

No. It lists only X accounts connected to your Xquik account. Use Search Users to find public profiles. Use Profile Lookup for one username.

Can I list multiple Twitter accounts?

Yes. The accounts array contains every connection owned by the authenticated Xquik account. The endpoint returns them in connection order. It has no page cursor, search term, status filter, or health filter. Filter the returned array locally when your workflow manages several accounts. Always keep the selected id paired with its xUsername.

Why is an active account not ready to write?

status stores the connection state. health interprets recent login results. An active row can still be locked, suspended, cooling down, or awaiting new credentials. Gate writes on health, not status alone.

What is the difference between ID and X user ID?

id identifies the Xquik connection. xUserId identifies the account on X. Write endpoints use the Xquik connection ID as accountId. Public read responses can use an X user ID for profile or Tweet relationships.

Why is cookiesObtainedAt missing?

The field is optional. It is omitted when the connection has not obtained a stored X session. Check health and complete the requested login action.

Which bearer token does this endpoint accept?

Send an OAuth bearer token accepted by Xquik. Do not send an app-only token from the X developer platform. See Authentication for the Xquik authorization flow.

When should I reauthenticate instead of bulk retry?

Use reauthentication for needsReauth. Supply current credentials and the saved Authenticator App TOTP secret. Use Bulk Retry only for eligible temporary failures. It cannot fix passwords, TOTP, passkeys, locks, or suspensions.

How do I confirm recovery?

Call this endpoint after the operator finishes the required action. Confirm the expected username and health. Resume writes only when the returned state fits your retry policy.

Next steps. Connect X Account, Re-authenticate X Account, or Bulk Retry.

{
  "accounts": [
    {
      "id": "42",
      "xUserId": "9876543210",
      "xUsername": "elonmusk",
      "status": "active",
      "health": "healthy"
    }
  ]
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

Connected X accounts API, health & write readiness

curl --request GET \
  --url https://xquik.com/api/v1/x/accounts

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/accounts"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "accounts": [
    {}
  ],
  "accounts[].id": "<string>",
  "accounts[].xUsername": "<string>",
  "accounts[].xUserId": "<string>",
  "accounts[].status": "<string>",
  "accounts[].health": "<string>",
  "accounts[].cookiesObtainedAt": "<string>",
  "accounts[].createdAt": "<string>",
  "accounts[].updatedAt": "<string>"
}

​When to list connected X accounts

​Scope, ordering & pagination

​Headers

​Response

​200 OK

​Choose the correct account identifier

​Preflight a write

​401 Unauthenticated

​429 Rate limited

​Account health

healthy

needsReauth

locked

suspended

recovering

temporaryIssue

​Account health decisions

​Connected X account questions

​Does this endpoint search Twitter accounts?

​Can I list multiple Twitter accounts?

​Why is an active account not ready to write?

​What is the difference between ID and X user ID?

​Why is cookiesObtainedAt missing?

​Which bearer token does this endpoint accept?

​When should I reauthenticate instead of bulk retry?

​How do I confirm recovery?

When to list connected X accounts

Scope, ordering & pagination

Headers

Response

200 OK

Choose the correct account identifier

Preflight a write

401 Unauthenticated

429 Rate limited

Account health

Account health decisions

Connected X account questions

Does this endpoint search Twitter accounts?

Can I list multiple Twitter accounts?

Why is an active account not ready to write?

What is the difference between ID and X user ID?

Why is cookiesObtainedAt missing?

Which bearer token does this endpoint accept?

When should I reauthenticate instead of bulk retry?

How do I confirm recovery?