---
title: "Get Account Usage"
method: GET
path: "/v3/account/usage"
tags: ["Account"]
---

# Get Account Usage

`GET /v3/account/usage`

Returns a full snapshot of your account status:
- **Credits** — total, used, and remaining for the current billing cycle
- **Rate limits** — current usage and reset times for daily, hourly, and per-minute windows
- **Plan** — your current plan category and renewal dates
- **Pricing** — credit cost per action type across all public API endpoints

> **Rate limit:** This endpoint is limited to 5 requests per minute.

## Response `200`

Successfully retrieved account usage

- AccountUsageResponse
  - `credits` CreditsUsage
    - `total` number
    - `used` number
    - `remaining` number
  - `rateLimits` RateLimits
    - `daily` RateLimitTier
      - `limit` number
      - `used` number
      - `remaining` number
      - `resetsAt` string, date-time
    - `hourly` RateLimitTier
      - `limit` number
      - `used` number
      - `remaining` number
      - `resetsAt` string, date-time
    - `minute` RateLimitTier
      - `limit` number
      - `used` number
      - `remaining` number
      - `resetsAt` string, date-time
  - `plan` PlanInfo
    - `category` string
    - `renewalType` string
    - `startDate` string, date-time
    - `endDate` string, date-time, nullable — Renewal/end date. Omitted (null) for free accounts, since they have no renewal cycle.
  - `pricing` object

## Other responses

- `401` — Unauthorized - invalid or missing API key
- `403` — Forbidden - account inactive, V3 access not enabled, or plan does not include this feature
- `429` — Too many requests - rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/lusha/apis/lusha-api-documentation.md) · [All operations](https://skmtc.net/lusha/apis/lusha-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lusha/lusha-api-documentation/revisions/8e73704e30b0/schema)