API docs | IP Geolocation API

API docs

Making requests

GET https://vpn-proxy-detection.ipify.org/api/v1?apiKey=YOUR_API_KEY&ipAddress=8.8.8.8
It takes up to 2 minutes to activate your account after Sign Up.

Input parameters

apiKey Required. Get your personal API KEY on My subscriptions page.
ipAddress Optional. IPv4 or IPv6 to search location by.

If the parameter is not specified, then it defaults to client request's public IP address.
domain Optional. Domain name to search location by.

If the parameter is not specified, then 'ipAddress' will be used.
email Optional. Email address or domain name to search location by it's MX servers.

If the parameter is not specified, then 'ipAddress' will be used.

Free access

After Sign Up you automatically get a free subscription plan limited to 1,000 credits.

Output format

{
    "ip": "8.8.8.8",
    "proxy": {
        "proxy": false,
        "vpn": false,
        "tor": false
    },
}
ip Requested (for search by 'ipAddress') or resolved (for search by 'domain' or 'email') IP address.
proxy.proxy The IP address is used as a proxy
proxy.vpn The IP address is a VPN endpoint
proxy.tor The IP address is a Tor endpoint

Account balance information

GET https://vpn-proxy-detection.ipify.org/service/account-balance?apiKey=YOUR_API_KEY
- You can always check your account balance on the My subscriptions page.
Try our VPN & Proxy Detection API free of charge
Get started
Have questions?

Or shoot us an email to