---
title: "Fair-use limits and credit balance"
method: GET
path: "/api/v1/usage/fair-use"
tags: ["Usage"]
---

# Fair-use limits and credit balance

`GET /api/v1/usage/fair-use`

## Request

- Base URL: `https://app.getleads.io`
- URL: `https://app.getleads.io/api/v1/usage/fair-use`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Returns fair-use caps (for unlimited plans) or remaining credits (for free plans).
Free (0 credits).

## Response `200`

Usage info

- object
  - `ok` boolean
  - `applies` boolean: True if fair-use caps are active (unlimited plan).
  - `plan` string
  - `exempt` boolean
  - `daily` object
    - `cap` integer
    - `used` integer
    - `remaining` integer
    - `period` string
    - `period_start` string, date-time
    - `resets_at` string, date-time
  - `monthly` object
    - `cap` integer
    - `used` integer
    - `remaining` integer
    - `period` string
    - `period_start` string, date-time
    - `resets_at` string, date-time
  - `binding` string: Which cap (daily or monthly) is currently binding.
  - `credits_remaining` integer: Remaining credits (free plan only).
  - `message` string

## Other responses

- `401`: Missing or invalid API key

---

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