API V2
Authentication
Some v2 endpoints require an active API key.
Bearer token
For endpoints that require an API key, send it in the Authorization header as Bearer YOUR_API_KEY.
Scopes
API keys may include a scopes JSON array to restrict which v2 services the key can call. Empty or null scopes keep legacy unrestricted access. Supported scopes are ip.full, proxy.check, proxy.list, smtp.validator, email.validate, and *.
No-key endpoints
Get IP, IP-to-Country, and MAC Lookup do not require an API key.
Key-required endpoints
IP Location, Proxy Check, Proxy List, and SMTP Validator require an active API key. Proxy List is unlimited with a valid key; IP Location, Proxy Check, and SMTP Validator are limited by plan.