Skip to main content
GET
Xquik account details & subscription status
Free - does not consume credits

Run an API account preflight

Call GET /account before a long tweet search, follower export, scheduled write, or monitor rollout. The response separates subscription access, available credits, active monitor cost, automatic top-up settings, and the linked X username. Use plan to report subscription state. Do not use it as a credit gate. Funded pay-as-you-go requests can continue while plan is inactive. Treat missing creditInfo as no recorded balance, not numeric zero. Do not use monitorsAllowed as a capacity limit. The field is deprecated and always reports the maximum safe integer. Use monitorsUsed and the monitor billing fields for cost checks.

Store an account billing snapshot

Persist a timestamped account snapshot before a worker starts billable work. Never convert credit strings to an unsafe JavaScript number.

Headers

string
required
Your API key. Generate one from the API Keys page.

Response

200 OK

string
Subscription status. "active" or "inactive".
number
Deprecated. Monitor slots are unlimited, so this is always 9007199254740991.
number
Number of currently active account monitors and keyword monitors.
object
Active monitor billing details. Monitor billing object fields.
string
Estimated daily credits for currently active monitors.
string
Credits charged each hour for currently active monitors.
string
Rounded daily credit estimate for 1 active monitor.
string
Hourly credits charged for 1 active monitor.
boolean
Whether webhook and event deliveries are included in monitor billing.
number
Active monitor check interval in seconds.
boolean
Whether monitor slot count is unlimited.
object
Credit balance details. Omitted if no credit balance row exists yet. Credit info object fields.
string
Current credit balance (Bigint string to preserve precision above Number.MAX_SAFE_INTEGER).
string
Total credits purchased across all time (Bigint string).
string
Total credits consumed across all time (Bigint string).
boolean
Whether automatic credit top-up is enabled.
number
Dollar amount charged when automatic top-up runs.
string
Credit balance threshold that triggers automatic top-up when enabled (Bigint string).
string
Linked X username. Omitted when no X account is connected.

401 Unauthenticated

Missing or invalid API key. Check the x-api-key header value.

429 Rate limited

Too many requests. Wait for the Retry-After header before retrying.

Credit balance

Every subscriber gets a monthly credit allowance. Metered reads bill per result or call. Writes bill per action. Active monitors bill 21 credits per hour. monitorsUsed, monitorBilling.activeHourlyBurn, and monitorBilling.activeDailyEstimate include active account monitors and active keyword monitors. The daily estimate is rounded. At 0 credits, metered calls return 402.