Catalog
MapsGETlive

IP geolocation lookup

Look up geolocation, network type, and country metadata for an IPv4 or IPv6 address.

$0.001
per call
Success
100%
p50 latency
1.55s
p95 latency
1.75s
Calls (30d)
3

Provider contract

Call path
/routes/auorio-ipstack/maps/ip-geolocation
Method
GET
Selected provider
auorio-ipstackdefault
Provider price
$0.001
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl '/routes/auorio-ipstack/maps/ip-geolocation?ip=8.8.8.8'
CLI
h402 call 'maps/ip-geolocation' --provider 'auorio-ipstack' --method GET --query '{"ip":"8.8.8.8"}'

Parameters & live test

pays real USDC

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

ipstringrequired

IPv4 or IPv6 address to geolocate.

e.g.
GET/routes/auorio-ipstack/maps/ip-geolocation
Request query
{
  "ip": "8.8.8.8"
}

ResponseExample response
{
  "data": {
    "ip": "8.8.8.8",
    "type": "ipv4",
    "continent_code": "NA",
    "continent_name": "North America",
    "country_code": "US",
    "country_name": "United States",
    "region_code": "CA",
    "region_name": "California",
    "city": "Mountain View",
    "zip": "94041",
    "latitude": 37.38801956176758,
    "longitude": -122.07431030273438,
    "msa": "41940",
    "dma": "807",
    "radius": "0",
    "ip_routing_type": "fixed",
    "connection_type": "ocx",
    "location": {
      "geoname_id": 7173909,
      "capital": "Washington D.C.",
      "languages": [
        {
          "code": "en",
          "name": "English",
          "native": "English"
        }
      ],
      "country_flag": "https://assets.ipstack.com/flags/us.svg",
      "country_flag_emoji": "🇺🇸",
      "country_flag_emoji_unicode": "U+1F1FA U+1F1F8",
      "calling_code": "1",
      "is_eu": false
    }
  },
  "h402": {
    "routeId": "maps/ip-geolocation",
    "provider": "auorio-ipstack",
    "selectedCandidateId": "maps/ip-geolocation/auorio-ipstack",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

auorio-ipstack
x402
100
Success
100%
p50
1.55s
Calls
3
100%
$0.001$0.0010/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider