GET https://xquik.com/api/v1/x/accounts
Free. This endpoint does not consume credits.
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 bycreatedAt 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.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
Thestatus 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 forRetry-After, then request the same page again.Next steps. Connect X Account,
Re-authenticate X Account, or
Bulk Retry.
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 }