Most IP-risk vendors hand you a PDF and a support ticket. IP99 by ThreatHunter publishes an OpenAPI 3.1 document at a stable URL you can import the same way you import any other public API: Postman, Insomnia, openapi-generator , or a GPT Action. One file describes the free profile, the quota endpoint, and the professional Pulse path — so your clients, types, and agent tools stay in sync with the live service instead of a blog post you copied six months ago.

This is a practical import walkthrough. Every curl below runs without an API key . Live samples were captured on 2026-10-31 (UTC).

What the spec actually covers

curl -s https://ip99.com/openapi.json | head -c 200 # → {"openapi":"3.1.0","info":{"title":"IP99 IP risk and geolocation API",...

Enter fullscreen mode

Exit fullscreen mode

As of today the document advertises OpenAPI 3.1.0 , title IP99 IP risk and geolocation API , version 1.0.0 , server https://ip99.com , and three paths:

Path What it is

GET /v1/ip/{ip} Free risk + geo + network profile…