Usage and metered lookups

Call GET /account with your secret key to read remaining allowances, request limits, additional-unit prices and monthly spending room. Account inspection is free.

Every plan pools a monthly request allowance across the APIs. New terms allow seven days of grace after the allowance is exceeded, ending sooner if the UTC calendar month resets. After grace, requests return quota_exceeded (429) until the month resets or an upgrade provides enough capacity. There are no automatic request overage charges. Existing teams keep their prior soft-limit policy until they switch plans. See your current terms in Dashboard → Plan.

Responses under the new monthly policy include X-Quota-Limit and X-Quota-Reset. X-Quota-Remaining reports the remaining requests when available; X-Quota-Grace-Until appears during grace. Reset and grace deadlines are UTC Unix timestamps in seconds. Monthly usage counts successful authenticated requests, including metered checks, and updates shortly after a response. These headers are separate from the per-minute rate limit.

Metered products have separate monthly allowances. Email and VAT meter deep checks. Carrier, Caller, and HLR meter the lookup itself. Free includes a limited allowance for these products, too.

When a metered allowance runs out, further checks require on-demand usage on an eligible plan. Enable it and set a shared monthly spending limit under Dashboard → Plan. Without available allowance or enabled on-demand usage, the check returns quota_exceeded. Basic Email and VAT checks work without ?deep=true while the monthly request allowance or grace period permits.

See Plans for included allowances and rates. Each endpoint explains what counts as a metered check.