{"openapi":"3.1.0","info":{"title":"IP Geolocation API","version":"1.0.0","description":"Geolocate any IPv4 or IPv6 address — country, region, city, postal code, latitude/longitude, timezone, calling code, currency and network details (ASN, ISP, organization). Look up any address or detect the caller's own public IP.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ipgeo-api","description":"oanor gateway"}],"tags":[{"name":"Geolocation"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/check":{"get":{"operationId":"get_v1_check","tags":["Geolocation"],"summary":"Geolocate the caller's own public IP","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ip":"178.105.17.60","city":"Gunzenhausen","type":"IPv4","is_eu":true,"postal":"91710","region":"Bavaria","source":"ipwho.is","country":"Germany","flag_img":"https://cdn.ipwhois.io/flags/de.svg","latitude":49.1200802,"timezone":"Europe/Berlin","continent":"Europe","longitude":10.7318864,"connection":{"asn":24940,"isp":"Hetzner Online GmbH","org":"CLOUD NBG1","domain":"hetzner.de"},"flag_emoji":"🇩🇪","utc_offset":"+02:00","region_code":"BY","calling_code":"+49","country_code":"DE","continent_code":"EU"},"meta":{"timestamp":"2026-05-29T21:28:58.851Z","request_id":"636fcbd5-4df0-4249-9564-d1c452dd86b9"},"status":"ok","message":"Caller IP geolocation retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/lookup":{"get":{"operationId":"get_v1_lookup","tags":["Geolocation"],"summary":"Geolocate any IPv4/IPv6 address","description":"","parameters":[{"name":"ip","in":"query","required":true,"description":"IPv4 or IPv6 address","schema":{"type":"string"},"example":"8.8.8.8"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ip":"8.8.8.8","city":"Mountain View","type":"IPv4","is_eu":false,"postal":"94039","region":"California","source":"ipwho.is","country":"United States","flag_img":"https://cdn.ipwhois.io/flags/us.svg","latitude":37.3860517,"timezone":"America/Los_Angeles","continent":"North America","longitude":-122.0838511,"connection":{"asn":15169,"isp":"Google LLC","org":"Google LLC","domain":"google.com"},"flag_emoji":"🇺🇸","utc_offset":"-07:00","region_code":"CA","calling_code":"+1","country_code":"US","continent_code":"NA"},"meta":{"timestamp":"2026-05-29T21:28:59.364Z","request_id":"dcbcb32d-079d-4b1d-8bb1-bd9ae7e81c30"},"status":"ok","message":"IP geolocation retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":5000,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1200,"monthly_call_quota":50000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3900,"monthly_call_quota":250000,"rps_limit":30,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":9900,"monthly_call_quota":1000000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ipgeo-api"}