> ## Documentation index
> Fetch the complete documentation index at: https://leadmcp.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Fair use budget

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

Authentication: API key.

Requires API key. 0 credits. Remaining fair-usage budget on unlimited plans, how many more rows you can pull today and this month across search, export, and enrich. Both windows reset on the UTC calendar (daily at the next 00:00 UTC, monthly at 00:00 UTC on the 1st), not 24 hours after you hit the cap, and not your local midnight; `binding` names the window that limits you first. Defaults are 500,000 rows/day and 6,000,000 rows/month, but caps are set per account, this endpoint is authoritative over any figure quoted elsewhere on this page, and if you're integrating at higher volume, message us and we'll raise yours. Paid and free plans get `applies: false` plus `credits_remaining`.

### Response fields

| Field | Type | Description |
| --- | --- | --- |
| `ok` | boolean | True when the request succeeded. |
| `applies` | boolean | True when fair use caps govern this account. |
| `plan` | string | The plan name for this account. |
| `exempt` | boolean | True when this account is exempt from the caps. |
| `daily` | object | The daily window: cap, used, remaining and reset time. |
| `monthly` | object | The monthly window: cap, used, remaining and reset time. |
| `binding` | string | The window that limits you first. |

### Example request

```bash
curl -sS "https://leadmcp.ai/api/v1/usage/fair-use" \
  -H "X-API-Key: lb_live_YOUR_API_KEY"
```

### Example response (200)

```json
{
  "ok": true,
  "applies": true,
  "plan": "unlimited",
  "exempt": false,
  "daily": {
    "cap": 500000,
    "used": 120000,
    "remaining": 380000,
    "period": "utc_calendar_day",
    "period_start": "2026-08-21T00:00:00.000Z",
    "resets_at": "2026-08-22T00:00:00.000Z"
  },
  "monthly": {
    "cap": 6000000,
    "used": 800000,
    "remaining": 5200000,
    "period": "utc_calendar_month",
    "period_start": "2026-08-01T00:00:00.000Z",
    "resets_at": "2026-09-01T00:00:00.000Z"
  },
  "binding": "daily"
}
```