Billing & limits

Fair use budget

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.

GET/api/v1/usage/fair-use

Authorization

Header	Type	Required	Description
`X-API-Key`	string	required	Your API key, for example `lb_live_YOUR_API_KEY`. You can send the same key as `Authorization: Bearer` instead.

Response

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.

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

Response200

{
  "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"
}