Supported clients
Any HTTP compatible client is supported, including your browser, cURL, HTTPie, GNU Wget and FreeBSD fetch.
| Client | Command |
|---|
| cURL | $ curl ip.e7d.io |
| HTTPie | $ http -b ip.e7d.io |
| GNU Wget | $ wget -qO- ip.e7d.io |
| fetch | $ fetch -qo- ip.e7d.io |
Different output formats are supported: HTML, JSON, Text, XML and YAML.
The response will use the first compatible output format listed in the "Accept" header, and JSON is always used as fallback.
The Output format can also be forced through URL:
Specific field query
Every field visible in the JSON, XML and YAML format can be queried specifically.
To do so, use the URL to query them, using a slashed syntax:
Query generator
FAQ
Is using this service from automated scripts/tools permitted?
Yes.
Is IPv6 supported?
Yes.
Is this service rate-limited?
Yes. 500 requests are accepted every 60 seconds.
In between requests will get a "429 Too Many Requests" error, with a Retry-After response header having a pair of values indicating when the next query will succeed.
Successful requests will get "RateLimit" headers indicating:
- X-RateLimit-Policy: the quota policy
- X-RateLimit-Remaining: the remaining quota in the current window
- X-RateLimit-Limit: the server's quota for requests by the client in the time window
- X-RateLimit-Reset: the time remaining in the current window, specified in seconds
Can I run my own service?
Yes, the source code is available on GitHub.
External resources
This product includes GeoLite2 data created by MaxMind, available from https://www.maxmind.com.
References
- ^ Autonomous system number
- ^ Administrative subdivisions are specific to each country and may or may not be specified.