GeoIP (Location Services)
Resolve network addresses to precise geographic coordinates and retrieve comprehensive jurisdictional metadata.
GeoIP API
The GeoIP API enables the resolution of IPv4 addresses into rich geographical and jurisdictional datasets. Beyond simple location coordinates, this service provides essential metadata—including currency systems, telecommunication prefixes, and linguistic profiles—enabling automated tax compliance (VAT/GST), regional content personalization, and fraud detection through threat-level auditing.
Intelligence Resolution (Geo-Location)
Retrieve the full intelligence profile for a specific IPv4 address. This includes Autonomous System (AS) data, high-level geolocation, and localized jurisdictional metadata.
geoip:readApiAccessPermission::GEOIP_READQuery Parameters
ipstringRequiredResponses
IP intelligence profile successfully resolved.
{
"requested_ip": "8.8.8.8",
"geolocation": {
"as_domain": "google.com",
"as_name": "Google LLC",
"asn": "AS15169",
"continent": "NA",
"country": "US",
"country_name": "United States"
},
"country_metadata": {
"name": "United States",
"phone": [
1
],
"capital": "Washington D.C.",
"currency": [
"USD",
"USN",
"USS"
],
"languages": [
"en"
]
},
"threats": [
"proxy",
"vpn"
],
"_credits": "IP address data powered by https://ipinfo.io"
}The provided IP address is malformed or resolution failed.
{
"error": "Unable to get info for this IP Address"
}Technical Implementation
curl --location --request GET \
'https://api.hub.donutwork.com/2026-02-01/geoip/ip.json?ip=8.8.8.8' \
--header 'Authorization: Bearer YOUR_API_TOKEN'const ipAddress = "8.8.8.8";
try {
const data = await sdk.geolocation.resolve(ipAddress);
console.dir(data, { depth: null });
} catch (error) {
console.error(`Resolution Failed: ${error.message}`);
}Business Context: Use this data to automate tax profile selection for checkout flows or to enforce regional compliance for regulated digital services.