System Operational

IP Intelligence
Infrastructure

Straightforward, no-nonsense IP address data. Open to everyone. Supports bulk queries, XML, YAML and JSON.

Start Integration
$ curl api.ipquery.io
No API Key Required
Unlimited Free Tier
api.ipquery.io/1.1.1.1

Drop-in Integration

Compatible with any stack that speaks HTTP. No SDKs, no bloat. Copy, paste, and ship.

example.js

API Endpoints

Base URL: https://api.ipquery.io

GET /

Returns your current IP address. If no specific format is requested, this endpoint defaults to returning plain text.

GET /{ip}

Returns full intelligence data for a specific IP address including location, ISP, and risk scoring.

GET /{ip},{ip}...

Bulk query multiple IP addresses in a single request. Comma separated. Results are returned as a list.

Batch limit: 10,000 IPs per request. Results are returned in order.

Data Dictionary

Location Object
countryStringFull name of the country.
country_codeStringTwo-letter ISO 3166-1 alpha-2 country code.
cityStringCity name.
stateStringRegion or state name.
zipcodeStringPostal code.
timezoneStringTimezone identifier.
Risk Object
is_mobileBooleanTrue if associated with cellular network.
is_vpnBooleanTrue if belongs to a known VPN provider.
is_torBooleanTrue if is a known Tor exit node.
is_proxyBooleanTrue if is a known public proxy.
risk_scoreInteger0-100 score indicating malicious activity likelihood.

Error Codes

Code Description
400 Bad Request - Invalid IP format or query parameters.
429 Too Many Requests - You have exceeded the rate limit.
500 Internal Server Error - Something went wrong on our end.

Common Questions

Is this really free?

Yes. We offer a public, free-tier API that covers most developer use-cases. We believe in open access to basic infrastructure data.

Any external dependencies?

No. All our data is aggregated and processed on our own infrastructure. You only rely on us, not third-party resolvers.

Can I use this for commercial projects?

Absolutely. You can integrate ipquery into commercial applications, SaaS products, and internal tools without restriction.

Do you log queries?

We only log transient data for caching and abuse prevention (rate limiting). We do not sell query data to third parties.