# Pocket Network IP Geolocation

> Pocket Network IP Geolocation is a paid API for AI agents from agent.pocket.network, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02).

Looks up geolocation data (country, region, city, postal code, coordinates, ASN, organisation) for a given IPv4 or IPv6 address, sourced from ipapi.co and cached.

## Facts

- Endpoint: POST https://agent.pocket.network/v1/ip-geolocation?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pocket-network-ip-geolocation-6fbb19bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_c8-mWCL4cFzMfviTn_PUm

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 pocket-network-ip-geolocation-6fbb19bf -d '<json body>'
```

Example prompt: What country, city, and organisation is the IP address 203.0.113.42 coming from? I need its full geolocation details including coordinates and ASN.

## When to prefer this

Choose this endpoint when you need a pay-per-request IP geolocation lookup with no account or API key setup, and you want to pay in USDC via the x402 protocol. Ideal for agents that need occasional or bursty geolocation calls without committing to a subscription, or for privacy-sensitive workflows where you prefer not to maintain credentials with a geolocation provider.

## Known failure modes

- Invalid IP address format returns an error
- Private or reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) may return no geolocation data
- Upstream ipapi.co outage may cause lookup failure
- Payment of 0.005 USDC must succeed via x402 or request is rejected
- Rate limiting or quota issues on the upstream provider side

## How this service works

IP geolocation: country, region, city, postal code, coordinates, ASN and organisation for an IPv4 or IPv6 address. Looked up from ipapi.co and cached. POST /v1/geo with {ip} and get one JSON object back. Pay per request in USDC; no account, no API key.

## Output

A JSON object containing the full geolocation profile of the submitted IP address, including country, region, city, postal code, latitude, longitude, ASN, and organisation name, along with portal metadata (serviceId, provenance, schemaCheck).

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "portal": {
   "serviceId": "ip-geolocation",
   "provenance": "third-party-supplier",
   "schemaCheck": "passed"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pocket-network-ip-geolocation-6fbb19bf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent.pocket.network](https://www.zero.xyz/host/agent.pocket.network/llms.txt)