Zum Inhalt springen
GET /v1/check

Geolocate the caller's own public IP

Live testen

10 freie Calls pro Tag — keine Anmeldung, kein API-Key. Geht durchs oanor-Gateway.

Eigene Header (optional)
api.oanor.com/ipgeo-api

Funktioniert. Hol dir einen API-Key und nutze sie in deinem Projekt.

API-Key holen

Code-Snippets

curl "https://api.oanor.com/ipgeo-api/v1/check" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/ipgeo-api/v1/check", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/ipgeo-api/v1/check");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/ipgeo-api/v1/check",
    headers={"x-oanor-key": "oanor_test_..."}
)

Beispiel-Response

Echte Antwort dieses Endpoints, erfasst beim letzten Health-Check.

{
    "data": {
        "ip": "178.105.17.60",
        "city": "Gunzenhausen",
        "type": "IPv4",
        "is_eu": true,
        "postal": "91710",
        "region": "Bavaria",
        "source": "ipwho.is",
        "country": "Germany",
        "currency": null,
        "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
}