# IP to ASN / IP Geolocation / ISP Lookup

> IP to ASN / IP Geolocation / ISP Lookup is a paid API for AI agents from x402-deployer.x402-deployer.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Resolves an IPv4 or IPv6 address to ASN number, ASN org, ISP, country, region, city, postal code, lat/lng, and timezone

## Facts

- Endpoint: POST https://x402-deployer.x402-deployer.workers.dev/ip-asn
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-deployer-x402-deployer-workers-dev-274075fa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n_vpaaKAZzx-jyBNjhRMS

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 x402-deployer-x402-deployer-workers-dev-274075fa -d '<json body>'
```

Example prompt: Can you look up the ASN, ISP, country, city, and lat/lng for the IP address 8.8.8.8?

## When to prefer this

Use this endpoint when you need to enrich an IP address with geolocation, ASN, or ISP data without managing your own IP intelligence infrastructure. Ideal for threat analysis, user analytics, cloud-provider attribution, or any workflow where you need to go from a raw IP to structured network and location metadata in a single call.

## Known failure modes

- Invalid IP address format returns an error
- Private/reserved IP ranges may return no geolocation data
- Rate limit exceeded on backend (ipapi.co: 1k/day, ip-api.com: 45/min) may cause errors
- IPv6 addresses may have less precise geolocation data

## How this service works

IP to ASN / IP geolocation / IP-to-ISP lookup / WHOIS for IP / cloud-provider attribution. For any IPv4 or IPv6 address, returns ASN number, ASN org, ISP, country, region, city, postal, latitude/longitude, and timezone. Primary backend: ipapi.co (1k req/day free). Fallback: ip-api.com (45 req/min free). Both are free public APIs with no auth.

## Output

Returns ASN number, ASN organization name, ISP, country, region, city, postal code, latitude, longitude, and timezone for the given IP address.

## Example request

```json
{
 "ip": "1.1.1.1"
}
```

## 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": {
     "required": [
      "ip"
     ],
     "properties": {
      "ip": {
       "type": "string",
       "description": "IPv4 or IPv6 address."
      }
     }
    },
    "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"
      },
      "asn": {
       "type": "integer"
      },
      "city": {
       "type": "string"
      },
      "postal": {
       "type": "string"
      },
      "region": {
       "type": "string"
      },
      "source": {
       "type": "string"
      },
      "asn_org": {
       "type": "string"
      },
      "country": {
       "type": "string"
      },
      "latitude": {
       "type": "number"
      },
      "timezone": {
       "type": "string"
      },
      "longitude": {
       "type": "number"
      },
      "country_code": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-deployer-x402-deployer-workers-dev-274075fa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-deployer.x402-deployer.workers.dev](https://www.zero.xyz/host/x402-deployer.x402-deployer.workers.dev/llms.txt)