Set up with your AI agent. Works with Claude Code, Cursor, Codex, VS Code and any agent that can run commands

AI coding agents: run curl -s https://ipbase.com/agents.md and follow it (API key, first call, plans).

IP Geolocation API

Turn any IP address into a location, an internet provider and a risk signal. One JSON call returns country, city, time zone, ISP, ASN and VPN, proxy and Tor flags.

Just one address? Look up any IP for free, no sign-up.


ip: "8.8.4.4",
country_code: "US",
country_name: "United States",
city: "Mountain View",
latitude: "48.1936",
longitude: "16.3726",
connection:
    asn: "15169",
    organization: "Google LLC",
    isp: "Google LLC",
    range: "8.8.4.0/24",
security:
    is_bot: "null",
    is_known_attacker: "null",
    is_proxy: "null",
    is_tor: "null",
    proxy_type: "null",
    threat_score: "null",
timezone:
    id: "America/New_York",
    current_time: "2023-02-21T11:57:12-05:00",
    code: "EST",
    is_daylight_saving: "false",
    gmt_offset: "-18000",
An error has occurred. Register for a free apikey to keep making requests!

Trusted by tech companies around the world

IP data for every use case

From a single sign-up form to enterprise fraud checks, the same IP geolocation API scales with you. Every endpoint and field is in our documentation.

IP API

Find the country, city, time zone and network of any IP address. Look up one address or up to 100 per request.

IP API

ASN API

Look up any ASN: its organization, country and IP ranges. Medium plan and above.

ASN API

Hosted Domains API

List the domains hosted on an IPv4 address. Medium plan and above.

Hosted Domains API

Built for developers

Plain REST and JSON, code examples, client libraries and an OpenAPI spec. Load the spec into your API client to try every endpoint before you write a line of code.

Integration Documentation

"ipbase.com's clear documentation, easy-to-use API, and great support team made it a no-brainer. It has given us the confidence to build our platform on top of their IP lookup API."

Wernhard Berger CEO Breatheilo GmbH

Why use ipbase.com?

Global coverage

We rebuild our IP data regularly from several sources, for IPv4 and IPv6 addresses.

Fast at any scale

Our infrastructure serves requests with industry-leading uptime. Location, network and security data are read from a local copy of the IP data, not from a third-party API. See the live uptime on our status page.

Quick to integrate

A plain REST API with thorough documentation, so integration takes minutes, not days.

What the IP geolocation API returns

One call to /v2/info returns these objects for an IPv4 or IPv6 address. Try it on any address with the free IP lookup.

location.country: Country name, ISO alpha-2 and alpha-3 codes, calling codes, flag emoji and EU membership.
location.region, location.city, location.zip: Region (with ISO code), city and postal code.
location.latitude, location.longitude: Coordinates of the location.
location.continent: Continent code and name.
connection: ASN, organization, ISP and the network range of the address.
timezone: Time zone ID, current local time, abbreviation, UTC offset and daylight saving.
security: VPN, proxy, Tor, data center and abuse flags with a threat score (Medium plan and above).

Related APIs: IP lookup API · VPN & proxy detection API · ASN API · Reverse IP API

Free IP tools

Look up an address, see your own IP and provider, or work out subnets and CIDR blocks in your browser. No sign-up needed. VPN and proxy flags, ASN data and hosted domains are on the Medium plan, so the free tools do not show them.

ASN lookup ASN owner and prefixes need the Medium plan. Bulk IP lookup Up to 100 IPs at once, CSV export. IP address converter Decimal, hex, binary, IPv4↔IPv6. IP address lookup Location and owner of any IP. IP range to CIDR converter Ranges to CIDR blocks and back. Reverse IP lookup Hosted domains need the Medium plan. Subnet calculator CIDR, netmask and host range. VPN and proxy checker VPN, proxy and Tor flags need the Medium plan. What is my IP address? Your public IP, location and provider. What is my ISP? Which internet provider you use.

All free tools · Cloud and crawler IP ranges

IP geolocation API: FAQ

What is an IP geolocation API?

An API that returns the location of an IP address, such as its country, region, city and coordinates, usually together with the network that owns it. ipbase also returns the time zone and, on the Medium plan and above, VPN, proxy and Tor flags.

How do I look up the location of an IP address?

Send GET https://api.ipbase.com/v2/info?ip=1.1.1.1 with your API key in the apikey header. Leave out the ip parameter to look up the address the request comes from.

Does the API support IPv6?

Yes. /v2/info accepts IPv4 and IPv6 addresses.

Can I look up many IP addresses at once?

Yes. POST /v2/batch looks up to 100 IP addresses per request; each address counts as one request of your quota.

Is there a free plan?

Yes. The free plan includes 150 requests a month with location data and batch lookups, limited to 10 requests a minute. No credit card is required.

Get started for free

150 free requests every month. Sign up, copy your API key and make your first call in a minute. No credit card required.