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. Free requests stop when the allowance is used up: upgrade to a paid plan with enough capacity or wait for the UTC monthly reset. Paid plans on current terms allow seven days of grace after the allowance is exceeded, ending sooner if the month resets. Blocked requests return quota_exceeded (429). 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 paid-plan 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 meters POST /email/verify. Carrier, Caller, and HLR meter the lookup itself. Included units depend on your account's terms.
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 GET /email/{email} validation remains available while the monthly request allowance or paid-plan grace period permits.
See Pricing for included allowances and rates. Each endpoint explains what counts as a metered check.
Questions? Email