---
title: "Get account info"
method: GET
path: "/api/v1/account"
tags: ["Account"]
---

# Get account info

`GET /api/v1/account`

Returns plan, credit, monitoring, and account settings for the authenticated user.

## Response `200`

Account info

- object
  - `plan` 'active' | 'inactive', required
  - `subscription` object, required — Subscription state without billing provider identifiers.
    - `status` 'none' | 'active' | 'past_due' | 'canceling' | 'incomplete', required
    - `tier` 'starter' | 'pro' | 'business'
    - `currentPeriodStart` string, date-time
    - `currentPeriodEnd` string, date-time — Renewal date, or the end date when canceling.
  - `monitorsUsed` integer, required
  - `monitorsAllowed` integer, required — Deprecated. Monitor slots are unlimited, so this is always Number.MAX_SAFE_INTEGER.
  - `monitorBilling` object, required
    - `activeDailyEstimate` string, required — Estimated daily credits for currently active monitors.
    - `activeHourlyBurn` string, required — Credits charged each hour for currently active monitors.
    - `creditsPerActiveMonitorDay` string, required — Rounded daily estimate for 1 active monitor.
    - `creditsPerActiveMonitorHour` string, required — Hourly credits charged for 1 active monitor.
    - `eventsIncluded` boolean, required — Webhook and event deliveries are included in monitor billing.
    - `instantCheckIntervalSeconds` integer, required — Active monitors check every 1 second.
    - `unlimitedSlots` boolean, required — Monitor slot count is unlimited.
  - `creditInfo` object
    - `balance` string, required — Bigint string to preserve precision above Number.MAX_SAFE_INTEGER.
    - `lifetimePurchased` string, required — Total purchased credits as a bigint string.
    - `lifetimeUsed` string, required — Total consumed credits as a bigint string.
    - `autoTopupEnabled` boolean, required
    - `autoTopupAmountDollars` number, required — Dollar amount charged when automatic top-up runs.
    - `autoTopupThreshold` string, required — Bigint string threshold that triggers automatic top-up when enabled.
  - `xUsername` string — Linked X username, omitted when no X account is connected.

## Other responses

- `401` — Unauthenticated
- `429` — Xquik tier rate limit exceeded. Wait `Retry-After` seconds before retrying.
- `default` — Unexpected error.

## Changes

- **2026-09-27** `c33250258fdf` — 12 warning
  - added the new `draw_too_large` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `429`
  - added the new `draw_too_large` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #2: StructuredError]/code` response property for the response status `429`
  - added the new `draw_too_large` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `401`
  - added the new `draw_too_large` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `default`
  - …8 more
- **2026-09-26** `9ae77b3e4fdc` — 6 warning
  - added the new `bookmark_folders_unavailable` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `429`
  - added the new `bookmark_folders_unavailable` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #2: StructuredError]/code` response property for the response status `429`
  - added the new `bookmark_folders_unavailable` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `401`
  - added the new `bookmark_folders_unavailable` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `default`
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/xquik-dev/apis/xquik-api-2/changes/api/v1/account/get.md)

---

[API](https://skmtc.dev/xquik-dev/apis/xquik-api-2.md) · [All operations](https://skmtc.dev/xquik-dev/apis/xquik-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/xquik-dev/apis/xquik-api-2/revisions/c33250258fdf?raw)