Connected X accounts API, health & write readiness

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

{
  "error": "invalid_input",
  "message": "Invalid account list cursor or limit."
}

{
  "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": [
    {}
  ],
  "hasMore": true,
  "nextCursor": "<string>",
  "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 X accounts connected to the authenticated Xquik account. Read each local ID, username, and health before a write. It does not search public Twitter accounts. Use Search Users for public profiles.

Check accounts[].health before every write. Use only a ready connection.

Common uses

Workflow	Use the response for
Before a Tweet, reply, DM, like, or follow	Select `accounts[].id`
After connection or reauthentication	Confirm username and health
Before scheduled work	Exclude blocked accounts
During support	Compare status, health, and timestamps

Scope, ordering & pagination

The response contains only connections owned by the authenticated Xquik account. Accounts are ordered by createdAt from earliest to latest. Equal timestamps use the connection ID as a stable tiebreaker. Send limit to enable cursor pagination. The default is 50. The maximum is 100. Pass nextCursor unchanged as cursor while hasMore is true. The best-practice contract paginates by default. Send this header:

xquik-api-contract: 2026-04-29

That contract returns has_more and next_cursor. The examples below show the default v1 camelCase fields. Legacy calls without limit or cursor return up to 10,000 connections. This keeps existing clients working. Larger lists receive cursor fields. New integrations should always paginate. An account without connections receives {"accounts": [], "hasMore": false} when pagination is active.

Request

curl "https://xquik.com/api/v1/x/accounts?limit=50" \
  -H "x-api-key: xq_YOUR_KEY_HERE"

const response = await fetch("https://xquik.com/api/v1/x/accounts?limit=50", {
  headers: { "x-api-key": "xq_YOUR_KEY_HERE" },
});
if (!response.ok) throw new Error(`List failed: ${response.status}`);
const page = await response.json();

Headers

string

Xquik API key. Generate one from the dashboard.

string

OAuth bearer token using Bearer YOUR_TOKEN.

Query parameters

integer

default:"50"

Page size from 1 through 100. Larger values are capped at 100.

string

Opaque nextCursor from the previous page. Do not decode or change it.

Read every page

let cursor;

do {
  const query = new URLSearchParams({ limit: "100" });
  if (cursor) query.set("cursor", cursor);

  const response = await fetch(`https://xquik.com/api/v1/x/accounts?${query}`, {
    headers: { "x-api-key": "xq_YOUR_KEY_HERE" },
  });
  if (!response.ok) throw new Error(`List failed: ${response.status}`);

  const page = await response.json();
  for (const account of page.accounts) {
    console.log(account.id, account.xUsername, account.health);
  }
  cursor = page.hasMore ? page.nextCursor : undefined;
} while (cursor);

Response

object[]

required

Connected X accounts. Empty when no connection exists.

boolean

true when another cursor page exists. Present on paginated responses.

string

Opaque cursor for the next page. Present only when another page exists.

string

required

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

string

required

Connected X username without @.

string

required

Stable X user ID. This is not the Xquik connection ID.

string

required

Stored connection status. Read health before writes.

string

required

Current write readiness. See Account health.

string

ISO 8601 session acquisition time. Omitted before login.

string

required

ISO 8601 connection creation time.

string

required

ISO 8601 time when the connection last changed.

{
  "accounts": [
    {
      "id": "3",
      "xUsername": "example",
      "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"
    }
  ],
  "hasMore": true,
  "nextCursor": "MjAyNi0wMi0yMFQwODoxNTowMC4wMDBafDM="
}

Choose the correct identifier

Field	Scope	Use
`id`	Xquik connection	Pass as `accountId` to write endpoints
`xUserId`	X account	Correlate public read responses
`xUsername`	Public handle	Confirm operator intent

Do not send xUserId where a write endpoint requires accountId.

Account health

The status field alone is insufficient. Gate writes on health.

Health	Write readiness	Next action
`healthy`	Ready	Continue with the intended write
`recovering`	Retry on use	Let the next action reconnect
`temporaryIssue`	Wait	Respect the cooldown
`needsReauth`	Blocked	Reauthenticate with current credentials
`locked`	Blocked	Complete recovery on X, then reauthenticate
`suspended`	Blocked	Resolve the suspension on X

Recovery details. needsReauth covers credentials, TOTP, email verification, passkeys, and other security challenges. Use reauth after resolving X-side prompts. locked can require account-side verification. suspended stays blocked until X restores the account. recovering reconnects on the next use. temporaryIssue stays paused during a transient cooldown. Use Bulk Retry only for eligible temporary failures. It cannot fix credentials, locks, or suspensions.

Errors

400 Invalid input

The cursor or limit is invalid. Restart without a cursor or send a valid limit.

401 Unauthenticated

Send a valid Xquik API key or OAuth bearer token.

429 Rate limited

Wait for Retry-After, then request the same page again.

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

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

{
  "error": "invalid_input",
  "message": "Invalid account list cursor or limit."
}

{
  "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": [
    {}
  ],
  "hasMore": true,
  "nextCursor": "<string>",
  "accounts[].id": "<string>",
  "accounts[].xUsername": "<string>",
  "accounts[].xUserId": "<string>",
  "accounts[].status": "<string>",
  "accounts[].health": "<string>",
  "accounts[].cookiesObtainedAt": "<string>",
  "accounts[].createdAt": "<string>",
  "accounts[].updatedAt": "<string>"
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Connected X accounts API, health & write readiness

Common uses

Request

Headers

Query parameters

Read every page

Response

Choose the correct identifier

Account health

Errors

400 Invalid input

401 Unauthenticated

429 Rate limited

​Common uses

​Scope, ordering & pagination

​Request

​Headers

​Query parameters

​Read every page

​Response

​Choose the correct identifier

​Account health

​Errors

​400 Invalid input

​401 Unauthenticated

​429 Rate limited

Common uses

Scope, ordering & pagination

Request

Headers

Query parameters

Read every page

Response

Choose the correct identifier

Account health

Errors

400 Invalid input

401 Unauthenticated

429 Rate limited