IP address info API

Input

Query parameters.

Example request

curl -i 'https://api.lookproof.dev/v1/ip/info?ip=192.0.2.1'

import asyncio
import os

from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact import register_exact_evm_client


async def main() -> None:
    signer = EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"]))
    client = register_exact_evm_client(x402Client(), signer, networks="eip155:8453")
    async with x402HttpxClient(client) as http:
        response = await http.get('https://api.lookproof.dev/v1/ip/info', params={'ip': '192.0.2.1'})
        response.raise_for_status()
        print(response.json())


asyncio.run(main())

import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);
const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const response = await fetchWithPayment("https://api.lookproof.dev/v1/ip/info?ip=192.0.2.1");
console.log(await response.json());

curl: unpaid request — returns 402 with the price (PAYMENT-REQUIRED). The Python and JavaScript clients pay it and send the request again. Only ordinary wallets (EOA) can pay; smart-contract wallets get a 402 without charge. See payments.

Example response

{
  "checked_at": "2026-10-24T12:00:00Z",
  "data": {
    "compressed": "192.0.2.1",
    "exploded": "192.0.2.1",
    "ip": "192.0.2.1",
    "ipv4_mapped": null,
    "is_global": false,
    "reverse_pointer": "1.2.0.192.in-addr.arpa",
    "scope": "documentation",
    "scope_source": {
      "network": "192.0.2.0/24",
      "registry": "IANA IPv4 Special-Purpose Address Registry",
      "rfc": "RFC 5737"
    },
    "version": 4
  },
  "endpoint": "ip.info",
  "findings": [
    {
      "code": "IP_NOT_GLOBAL",
      "evidence": {
        "count": 1,
        "items": [
          {
            "ip": "192.0.2.1",
            "scope": "documentation"
          }
        ]
      },
      "explanation": "The address is in a special-purpose block (IANA's IPv4 and IPv6 Special-Purpose Address Registries), for example private, loopback, link-local, shared address space or documentation. The scope and its RFC are in the result. Such an address cannot be reached from the public internet.",
      "message": "The address is not globally routable.",
      "recommendation": null,
      "severity": "info"
    }
  ],
  "meta": {
    "cache_hit": false,
    "duration_ms": 42,
    "fresh_until": "2026-10-24T12:05:00Z",
    "observed_at": "2026-10-24T12:00:00Z",
    "resolver": null,
    "source": "offline"
  },
  "request_id": "req_aaaaaaaaaaaaaaaaaaaaaaaaaa",
  "schema_version": "1.0",
  "status": "info"
}

Response fields

Fields in data

Status codes

Errors use the common error body. See errors.

Findings this endpoint can return