Current Plan Usage (Unlimited Plans)
Check your unlimited plan’s consumption: single lookups used against the monthly cap, bulk searches used against the daily limit, and when each resets.
single_rps (your plan’s per-account requests-per-second limit for single lookups) and the billing period bounds (current_period_start, current_period_end). All timestamps are ISO 8601 in UTC.
Calling this endpoint is free: it consumes neither the monthly cap nor the daily search limit. It does share the per-key request-rate window with the rest of the API, so avoid polling it in a tight loop.
The daily bulk search meter is per account, so its numbers include dashboard bulk finder jobs run on your plan, not just API submissions.
Requires an Unlimited API key with an active subscription; the same 402 subscription_inactive and 403 wrong_key_plan rules apply as on the other unlimited endpoints.Authorizations
API key for authentication
Response
Successful Response
Current-period consumption for an unlimited plan (/v1/unlimited/usage).
Plan's single-lookup requests per billing period.
Single-lookup requests consumed this billing period.
Requests remaining before the monthly cap (never negative).
Plan's single-lookup requests-per-second limit (per account).
Plan's daily bulk search limit (per account, UTC day).
Bulk searches consumed in the current daily window.
When the daily bulk search limit resets (next UTC midnight).
Start of the current billing period (cap window).
End of the current billing period — when the cap resets.