X account connection API | get 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 | get 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>",
  "cookiesObtainedAt": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Choose one account health check

Use this route as a health gate before one connected-account write. Read health, recovery, and credential state before selecting the next action. Use list only for account-wide inventory.

Free - 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. cookiesObtainedAt shows when the session was last obtained and is omitted 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 the account is fixed 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 (e.g. "active").

string

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

string

ISO 8601 timestamp of when session cookies were last obtained. Omitted if not yet authenticated.

string

ISO 8601 timestamp of when the account was connected.

string

ISO 8601 timestamp of the last update.

{
  "id": "3",
  "xUsername": "elonmusk",
  "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"
}

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 | get 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>",
  "cookiesObtainedAt": "<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 | get profile status

Choose one account health check

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

​Choose one account health check

​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

Choose one account health check

Read the account state

Path parameters

Headers

Response

200 OK

400 Invalid ID

401 Unauthenticated

404 Not found

429 Rate limited