# IP Geolocation Lookup via the402.ai

> IP Geolocation Lookup via the402.ai is a paid API for AI agents from api.the402.ai, paid per call via x402, $0.002/call, status down (last checked 2026-09-15).

Returns geographic location data for a given IP address, paid per-call via x402 micropayment protocol

## Facts

- Endpoint: POST https://api.the402.ai/v1/services/svc_6a13d276dd0e4c13/purchase
- Price: $0.002/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-the402-ai-b3d02516
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lVf4tiGwoVLZ2TENaP0t1

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 api-the402-ai-b3d02516 -d '<json body>'
```

Example prompt: Can you look up the geographic location of IP address 203.0.113.47 and tell me the country, city, and timezone it maps to?

## When to prefer this

Choose this endpoint when you need per-call IP geolocation billed via x402 USDC micropayments without a subscription, especially in agentic workflows where you pay only for what you use. Ideal for AI agents that need to enrich event data, logs, or user sessions with geographic context on demand.

## Known failure modes

- Invalid or malformed IP address returns a 400-level error
- Private/reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) may return no location data
- Payment failure via x402 returns a 402 Payment Required error
- Rate limiting or quota exceeded returns a 429 error
- Unresolvable IP returns empty or null geolocation fields

## How this service works

Purchase: IP Geolocation

## Output

Returns geolocation data for the queried IP address including country, region, city, coordinates (latitude/longitude), timezone, and ISP information. The call costs $0.002 USDC charged via x402 micropayment.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "job_id": {
   "type": "string"
  },
  "status": {
   "type": "string"
  },
  "thread_id": {
   "type": "string"
  }
 }
}
```

## More

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