---
title: "Get plan limits and current usage"
method: GET
path: "/profile/usage"
tags: ["Profile"]
---

# Get plan limits and current usage

`GET /profile/usage`

Return every plan limit alongside its current consumption for the authenticated account.

Scope
- All counters are account-owner scoped: a team member sees the owner's consumption, since quotas are shared across the team.

Semantics
- `limit: null` means unlimited.
- `used: null` means the counter is momentarily unreadable (never 0 by default, so the UI can tell 'unknown' from 'nothing consumed').
- `caps_enforced: false` means the caps of your plan are not being applied.
- `legacy_caps: true` means the daily request cap is not enforced on this account (concurrency caps still are).

This endpoint never mutates a counter: reading it does not consume quota.

## Response `200`

Usage returned successfully.

- PlanUsageResponse — Plan limits and their live consumption, account-owner scoped. Counters are shared across a team: a member sees the owner's consumption.
  - `caps_enforced` boolean — False when the caps of your plan are not being applied.
  - `legacy_caps` boolean — The daily request cap is not enforced on this account.
  - `is_team_member` boolean
  - `plan_name` string, nullable
  - `is_paid` boolean
  - `requests_daily` UsageMetric, required — One plan dimension: how much of it is consumed right now. ``limit = None`` means unlimited, ``used = None`` means the counter could not be read right now and the UI should show "unavailable" rather than 0.
    - `used` integer, nullable — Current consumption, null when unreadable.
    - `limit` integer, nullable — Plan limit, null when unlimited.
  - `requests_daily_reset_epoch` integer, nullable — Unix epoch of the next hourly rollover.
  - `concurrent_raw` UsageMetric, required — One plan dimension: how much of it is consumed right now. ``limit = None`` means unlimited, ``used = None`` means the counter could not be read right now and the UI should show "unavailable" rather than 0.
    - `used` integer, nullable — Current consumption, null when unreadable.
    - `limit` integer, nullable — Plan limit, null when unlimited.
  - `concurrent_advanced` UsageMetric, required — One plan dimension: how much of it is consumed right now. ``limit = None`` means unlimited, ``used = None`` means the counter could not be read right now and the UI should show "unavailable" rather than 0.
    - `used` integer, nullable — Current consumption, null when unreadable.
    - `limit` integer, nullable — Plan limit, null when unlimited.
  - `unlocked_lists` UsageMetric, required — One plan dimension: how much of it is consumed right now. ``limit = None`` means unlimited, ``used = None`` means the counter could not be read right now and the UI should show "unavailable" rather than 0.
    - `used` integer, nullable — Current consumption, null when unreadable.
    - `limit` integer, nullable — Plan limit, null when unlimited.
  - `team` TeamUsageMetric, required
    - `used` integer, nullable — Current consumption, null when unreadable.
    - `limit` integer, nullable — Plan limit, null when unlimited.
    - `pending` integer — Pending invitations, they hold a seat.
    - `enabled` boolean — Whether the plan allows a team at all.
  - `monitoring` MonitoringUsageMetric, required
    - `used` integer, nullable — Current consumption, null when unreadable.
    - `limit` integer, nullable — Plan limit, null when unlimited.
    - `plan_limit` integer — Slots granted by the plan (or free tier baseline).
    - `extra_limit` integer — Slots bought on top of the plan.

## Other responses

- `401` — Authentication required, or invalid/expired API key.

---

[API](https://skmtc.dev/leakradar/apis/leakradar-io-api.md) · [All operations](https://skmtc.dev/leakradar/apis/leakradar-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/leakradar/leakradar-io-api/revisions/82a99c608e1a/schema)