# IP Geolocation Lookup API

> IP Geolocation Lookup API is a paid API for AI agents from ip-geo-api-production.up.railway.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Geolocates a single IPv4 or IPv6 address, returning country, region, city, postcode, lat/lng, timezone, ISP, organization, ASN, and datacenter detection.

## Facts

- Endpoint: POST https://ip-geo-api-production.up.railway.app/lookup/ip
- 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/ip-geolocation-lookup-api-4001ee4e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CT6CcgZ0-vpEIaPHkbKPA

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-geolocation-lookup-api-4001ee4e -d '<json body>'
```

Example prompt: Can you look up where 185.220.101.45 is located — I need the country, city, ISP, and whether it's coming from a datacenter?

## When to prefer this

Use this endpoint when you need detailed geolocation for a single IP address including ISP, ASN, organization, and a datacenter heuristic — especially useful for fraud detection, traffic auditing, or user personalization pipelines. Prefer the sibling batch endpoint when you have up to 20 IPs to resolve at once, or the distance endpoint when you need to compare two IP locations.

## Known failure modes

- Invalid or malformed IP address returns a 4xx error
- Private/reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) may return no geolocation data
- Recently allocated or very new IPs may lack database coverage
- Payment failure (x402) if USDC balance is insufficient
- Service unavailability on Railway deployment infrastructure

## How this service works

Geolocate an IPv4/IPv6 address: country, region, city, postcode, lat/lng, timezone, ISP, org, ASN, and a datacenter heuristic.

## Output

Returns a structured record for the queried IP including: country name and code, region, city, postcode, latitude, longitude, timezone, ISP name, organization name, ASN, and a boolean or heuristic flag indicating whether the IP belongs to a datacenter or hosting provider.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ip": {
   "type": "string",
   "description": "IPv4 or IPv6 address to geolocate, e.g. '8.8.8.8'."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ip-geolocation-lookup-api-4001ee4e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ip-geo-api-production.up.railway.app](https://www.zero.xyz/host/ip-geo-api-production.up.railway.app/llms.txt)