IP Location.net API site

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.