Skip to main content
GET https://xquik.com/api/v1/x/accounts
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

Scope, ordering & pagination

The response contains only connections owned by the authenticated Xquik account. The API orders accounts by createdAt from earliest to latest. The connection ID breaks ties between equal timestamps. Send limit to enable cursor pagination. The default is 50. The maximum is 10,000. Pass nextCursor unchanged as cursor while hasMore is true. The opt-in contract paginates by default. Send this header.
That contract returns has_more and next_cursor. The examples below show the default v1 camelCase fields. Calls without limit or cursor return up to 10,000 connections. Existing clients keep working. Larger lists receive cursor fields. Paginate in new integrations. An account without connections receives {"accounts": [], "hasMore": false} when pagination is active.

Request

Headers

Query parameters

Read every page

Response

Choose the correct identifier

Do not send xUserId where a write endpoint requires accountId.

Account health

The status field alone is not enough. Check health before every write.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.

Response examples

200 example

  • 400 { "error": "invalid_input", "message": "Invalid account list cursor or limit." }
  • 401 { "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." }
  • 403 { "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." }
  • 429 { "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }