Finowl
Send an IP address
Post an IPv4 or IPv6 address to the IP Geolocation endpoint, authenticated with your API key.
FINOWL / IP GEOLOCATION
An IP address. Where it is.
Get the city, region, country, latitude and longitude, and time zone of any IPv4 or IPv6 address. Answered in memory on Finowl's own servers, from data refreshed daily.
HOW IT WORKS
One address in.
A place out.
A single request returns the location your localization, scheduling or analytics workflow needs.
Match location data
Finowl matches the address against location data held in memory and refreshed daily. Nothing is called per request.
Get the place
Receive the country, region, city, coordinates, time zone and local time, with details of the country.
SEE IT IN ACTION
From an IP address
to a place on the map.
curl https://api.finowl.co/v1/ip/geolocation \ -H "Authorization: Bearer $FINOWL_API_KEY" \ -H "Content-Type: application/json" \ --data '{ "ip": "8.8.8.8" }'{ "ip": "8.8.8.8", "version": 4, "reserved": false, "country_code": "US", "country": "United States", "region": "California", "city": "Mountain View", "location": { "latitude": 37.422, "longitude": -122.085, "timezone": "America/Los_Angeles", "local_time": "2026-10-15T10:27:05-07:00", "utc_offset": "-07:00" }, "country_info": { "code": "US", "name": "United States", "flag": "🇺🇸", "continent": "North America", "currency": "USD", "language": "en", "in_eu": false, "calling_code": 1 }}WHERE IT FITS
Meet people
where they are.
Localization
Choose a sensible default country, language or currency for a first visit, and let people change it.
Local time
Show times in the visitor's time zone, or schedule a message for working hours where they are.
Regional content
Point visitors to the nearest region, store or data center, and report where your traffic comes from.
IP location describes a network, not a person. Let people change anything you set from it.
THE RESPONSE
Clear fields. Honest limits.
Every response describes where an address is registered, with unknown fields left empty.
Country is reliable; city and coordinates are approximate. Need to know whether to trust the traffic too? Use IP Intelligence.
IP geolocation by DB-IP, licensed under CC BY 4.0.
Time zones from GeoNames, licensed under CC BY 4.0.
- country, country_code
- The country the address is registered to, or empty when unknown.
- region, city
- The approximate region and city, or null when unknown.
- location
- Approximate latitude and longitude, the IANA time zone, the local time there right now and its UTC offset.
- country_info
- The country's flag, continent, currency, main language, calling code and EU membership.
- reserved
- True for private, loopback, link-local and other non-public ranges. Location fields are then empty.
- ip, version
- The address in canonical form and whether it is IPv4 or IPv6.
A FEW GOOD QUESTIONS
IP Geolocation questions, answered.
Know where traffic comes from.
Add country, city and time zone to your next localization or analytics workflow.