---
title: "Get account quota & usage"
method: GET
path: "/account"
tags: ["Account"]
---

# Get account quota & usage

`GET /account`

Read your account's current plan, entitlement and live usage in one response — without spending a credit. Free: this endpoint never debits your quota, and it keeps working even when your monthly quota is exhausted (so you can read your balance to know when it resets). Rate-limited to 1 request/second per account (burst 5).

The snapshot reflects the EFFECTIVE state your next request would be served under: a lapsed paid subscription (e.g. past_due/canceled) is reported as the free plan it falls back to, and an expired free period is shown already reset. Trust `subscriptionStatus` for the underlying billing state.

## Response `200`

Account entitlement and usage snapshot

- AccountResponse
  - `plan` string, required — Effective plan tier your next request would use. A lapsed paid subscription is reported as the fallback it drops to: 'free' on a personal team, 'none' (no usable quota) on an additional team.
  - `status` string, required — Plan status
  - `subscriptionStatus` string, nullable — Underlying Stripe subscription status (null for free plans without a subscription). Authoritative billing signal: a value other than 'active'/'trialing' means the paid subscription has lapsed even though `plan` reports the fallback tier.
  - `usage` object, required
    - `used` integer, required — Credits used this billing period
    - `limit` integer, required — Monthly credit limit (comp overrides applied)
    - `remaining` integer, required — Credits remaining (max(0, limit - used))
    - `resetDate` string, date-time, nullable, required — When the current period ends and usage resets
  - `rateLimitPerMinute` integer, required — The plan's per-minute rate limit for the paid data endpoints

## Other responses

- `403` — Invalid or missing API key, or suspended account
- `404` — No plan found for this account
- `429` — Rate limit exceeded (free account endpoint limit: 1 request/second)

## Changes

- **2026-08-10** `cf1d4e12baca` — 9 info
  - added the optional property `code` to the response with the `403` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `429` status
  - added the optional property `message` to the response with the `403` status
  - …5 more

[Change history](https://skmtc.dev/carapi/apis/carapi-dev-automotive-data-api/changes/account/get.md)

---

[API](https://skmtc.dev/carapi/apis/carapi-dev-automotive-data-api.md) · [All operations](https://skmtc.dev/carapi/apis/carapi-dev-automotive-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/carapi/carapi-dev-automotive-data-api/revisions/cf1d4e12baca/schema)