X account connection API for profile status

{
  "id": "42",
  "xUserId": "9876543210",
  "xUsername": "elonmusk",
  "status": "active",
  "health": "healthy",
  "createdAt": "2025-01-15T12:00:00Z"
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

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

{
  "error": "not_found",
  "message": "Resource not found."
}

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

GET

accounts

{id}

X account connection API for profile status

curl --request GET \
  --url https://xquik.com/api/v1/x/accounts/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://xquik.com/api/v1/x/accounts/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

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

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "id": "<string>",
  "xUsername": "<string>",
  "xUserId": "<string>",
  "status": "<string>",
  "health": "<string>",
  "connectedAt": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

When to check one account

Call this route before one connected-account write. Read health, recovery, and credential state before selecting the next action. Use list to see every connected account.

Free. This endpoint does not consume credits.

Use this endpoint before a workflow acts with one connected account. Read health first. Write with healthy. Use recovering on the next action. Wait or bulk retry temporaryIssue. Re-authenticate needsReauth. Fix locked or suspended on X before retrying writes.

Read the account state

Ready for actions

health: "healthy" means the stored session is usable. connectedAt shows when the account last connected or reconnected. The API omits it if the account has not authenticated yet.

Needs credentials

health: "needsReauth" means credentials, TOTP, email verification, passkey, or another security challenge blocked login. Use Re-authenticate with current credentials and a valid TOTP secret before retrying writes.

Temporary recovery

health: "temporaryIssue" means a transient or automated cooldown is still active. Wait for recovery, or use Bulk retry for temporary failures. health: "recovering" means the account can reconnect on its next use.

X restriction

health: "locked" or health: "suspended" means writes stay blocked until you fix the account on X. Re-authenticate or reconnect only after the account is usable again.

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

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

import requests

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

package main

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

func main() {
    accountID := "3"
    req, err := http.NewRequest("GET", "https://xquik.com/api/v1/x/accounts/"+accountID, 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)
}

Path parameters

string

required

The unique account ID. Returned when you connect an account or list accounts.

Headers

string

required

Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.

Response

200 OK

string

Unique account ID.

string

X username.

string

X user ID.

string

Account connection status (for example "active").

string

Derived login and cookie health. One of healthy, locked, needsReauth, recovering, suspended, temporaryIssue. See Account health for meanings.

string

ISO 8601 timestamp of when the account last connected or reconnected. Omitted if not yet authenticated.

string

ISO 8601 timestamp of when you connected the account.

string

ISO 8601 timestamp of the last update.

{
  "id": "3",
  "xUsername": "elonmusk",
  "xUserId": "44196397",
  "status": "active",
  "health": "healthy",
  "connectedAt": "2026-02-20T08:15:00.000Z",
  "createdAt": "2026-02-20T08:15:00.000Z",
  "updatedAt": "2026-02-20T08:15:00.000Z"
}

400 Invalid ID

{ "error": "invalid_id", "message": "Invalid account ID format" }

The provided account ID is not a valid format.

401 Unauthenticated

{ "error": "unauthenticated", "message": "Missing or invalid API key" }

Missing or invalid API key.

404 Not found

{ "error": "not_found", "message": "Resource not found." }

No account exists with this ID, or it belongs to a different Xquik account.

429 Rate limited

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

Wait for the Retry-After value before fetching this account again.

Related. List X Accounts to see all accounts, Disconnect to remove this account, or Re-authenticate if the session has expired.

{
  "id": "42",
  "xUserId": "9876543210",
  "xUsername": "elonmusk",
  "status": "active",
  "health": "healthy",
  "createdAt": "2025-01-15T12:00:00Z"
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

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

{
  "error": "not_found",
  "message": "Resource not found."
}

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

X account connection API for profile status

curl --request GET \
  --url https://xquik.com/api/v1/x/accounts/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://xquik.com/api/v1/x/accounts/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

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

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "id": "<string>",
  "xUsername": "<string>",
  "xUserId": "<string>",
  "status": "<string>",
  "health": "<string>",
  "connectedAt": "<string>",
  "createdAt": "<string>",
  "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

X account connection API for profile status

When to check one account

Read the account state

Ready for actions

Needs credentials

Temporary recovery

X restriction

Path parameters

Headers

Response

200 OK

400 Invalid ID

401 Unauthenticated

404 Not found

429 Rate limited

​When to check one account

​Read the account state

Ready for actions

Needs credentials

Temporary recovery

X restriction

​Path parameters

​Headers

​Response

​200 OK

​400 Invalid ID

​401 Unauthenticated

​404 Not found

​429 Rate limited

When to check one account

Read the account state

Path parameters

Headers

Response

200 OK

400 Invalid ID

401 Unauthenticated

404 Not found

429 Rate limited