Skip to main content
GET https://xquik.com/api/v1/x/account-connection-attempts/{id}
Free. This endpoint does not consume credits.
This takes a dashboard session, or a key with the Connect X accounts permission. Turn it on at dashboard.xquik.com/api-keys. Full access doesn’t include it. A key without it gets 403 x_account_connect_permission_required. OAuth tokens and MCP tools get 403 session_required. An ID this account never started reads as pending, like one still registering.
Check this endpoint after the connect response’s Retry-After delay. You can call other Xquik routes while the connection continues. Do not send the credentials again while status is pending.

Headers

Path

Response

Every 200 response includes Cache-Control: no-store.

200 Pending

The response includes Retry-After: 3. Wait, then check the same attempt.

200 Success

The account is ready. Pass accountId as account on later calls.

200 Email code required

Submit the newest code to Submit X Account Email Code.

200 Failed

Stop checking this attempt. Start a new connection only when retryable is true.

400 Invalid input

{ "error": "invalid_input", "message": "Invalid connection attempt ID. Check the path parameter." } The attempt ID is malformed, unavailable, or belongs to another account. Xquik does not keep attempts forever. Save the final result.

401 Unauthenticated

{ "error": "unauthenticated", "message": "Missing or invalid API key" } The API key is missing or invalid.

429 Rate limited

{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 1 } Wait for Retry-After before checking again.
Related. Connect X Account starts the attempt. Submit X Account Email Code completes an email challenge.

Response examples

  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 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 }