# IP Lookup API

> IP Lookup API is a paid API for AI agents from tools.ipintel.ai, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Returns geolocation, ISP, ASN, proxy detection, and reverse DNS data for a given IP address

## Facts

- Endpoint: POST https://tools.ipintel.ai/ip-lookup
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ip-lookup-api-548570bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QJvePZeI-qvwqntlynpX-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ip-lookup-api-548570bf -d '<json body>'
```

Example prompt: Can you look up the IP address 8.8.8.8 and tell me its location, ISP, ASN, and whether it's a proxy or hosting provider?

## When to prefer this

Choose this endpoint when you need comprehensive IP intelligence in a single call — combining geolocation, ISP/ASN data, proxy detection, mobile detection, hosting detection, and reverse DNS together. It is a pay-per-call x402 API suitable for autonomous agents that need cost-transparent, on-demand IP enrichment without a subscription. Prefer it over generic geolocation APIs when proxy/VPN and hosting classification are also required in the same response.

## Known failure modes

- Invalid IP address format returns an error or ok:false
- Private/reserved IP ranges may return incomplete or no geolocation data
- Unknown IPs with no database coverage may return empty city/region fields
- Rate limiting or payment failure results in a 402 or rejection response
- Proxy/hosting detection may have false positives for shared infrastructure

## How this service works

Pay-per-call x402 APIs for satellite observation, DNS lookup, domain health checks, reverse DNS, WHOIS lookup, domain availability checks, JSON Schema validation, JWT decoding, Base64 encoding/decoding, and HTTP latency checks. Designed for autonomous agents, developers, domain diagnostics, registration availability checks, API testing, structured output validation, token inspection, data transformation, uptime checks, and HTTP latency diagnostics.

## Output

Returns a JSON object with the queried IP, a success flag, ASN, ISP name, organization, zip code, city, region, country, country code, region code, latitude, longitude, timezone, UTC offset, proxy flag, mobile flag, hosting flag, reverse DNS hostname, service name, and a timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "ip"
     ],
     "properties": {
      "ip": {
       "type": "string",
       "description": "IPv4 or IPv6 address to enrich, for example 8.8.8.8"
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "ip": {
       "type": "string"
      },
      "ok": {
       "type": "boolean"
      },
      "asn": {
       "type": "string"
      },
      "isp": {
       "type": "string"
      },
      "org": {
       "type": "string"
      },
      "zip": {
       "type": "string"
      },
      "city": {
       "type": "string"
      },
      "proxy": {
       "type": "boolean"
      },
      "mobile": {
       "type": "boolean"
      },
      "region": {
       "type": "string"
      },
      "as_name": {
       "type": "string"
      },
      "country": {
       "type": "string"
      },
      "hosting": {
       "type": "boolean"
      },
      "reverse": {
       "type": "string"
      },
      "service": {
       "type": "string"
      },
      "latitude": {
       "type": "number"
      },
      "timezone": {
       "type": "string"
      },
      "longitude": {
       "type": "number"
      },
      "timestamp": {
       "type": "string"
      },
      "region_code": {
       "type": "string"
      },
      "country_code": {
       "type": "string"
      },
      "utc_offset_seconds": {
       "type": "integer"
      }
     },
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ip": "8.8.8.8",
  "ok": true,
  "asn": "AS15169",
  "isp": "Google LLC",
  "org": "Google Public DNS",
  "zip": "20149",
  "city": "Ashburn",
  "proxy": false,
  "mobile": false,
  "region": "Virginia",
  "as_name": "GOOGLE",
  "country": "United States",
  "hosting": true,
  "reverse": "dns.google",
  "service": "ip_lookup",
  "latitude": 39.03,
  "timezone": "America/New_York",
  "longitude": -77.5,
  "timestamp": "2026-07-05T16:55:43+00:00",
  "region_code": "VA",
  "country_code": "US",
  "utc_offset_seconds": -14400
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ip-lookup-api-548570bf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.ipintel.ai](https://www.zero.xyz/host/tools.ipintel.ai/llms.txt)