# Tollkit IP Geolocation

> Tollkit IP Geolocation is a paid API for AI agents from extract.tollkit.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Resolves an IPv4 or IPv6 address to its country, region, city, continent, and approximate latitude/longitude using the DB-IP City Lite database.

## Facts

- Endpoint: POST https://extract.tollkit.dev/ip?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tollkit-ip-geolocation-48363a1c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aiIUriGJDv8Gd9VPwSMmN

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 tollkit-ip-geolocation-48363a1c -d '<json body>'
```

Example prompt: Can you look up where the IP address 203.0.113.45 is located — I need its country, city, region, and approximate coordinates?

## When to prefer this

Choose this endpoint when you need a lightweight, pay-per-call IP geolocation with city-level granularity and no account or API key required. It is ideal for sporadic or low-volume lookups where subscribing to a full geolocation service is overkill. The x402 micropayment model at $0.002/call makes it cost-effective for agents that only occasionally need IP location data. Prefer alternatives if you need ISP/ASN data, threat intelligence, or high-volume batch processing.

## Known failure modes

- Private or reserved IP addresses (e.g. 192.168.x.x, 10.x.x.x, ::1) return no location data and are not billed
- Malformed or invalid IP string may result in an error response
- Some IPs may not be present in the DB-IP City Lite database, returning partial or empty fields
- IPv6 geolocation accuracy may be lower than IPv4 in some regions

## How this service works

IP geolocation: give an IPv4 or IPv6 address, get its country, region, city, continent and approximate latitude/longitude. City-level, from the DB-IP City Lite database (IP Geolocation by DB-IP, CC BY 4.0). $0.002 per lookup; private or reserved addresses are not charged.

## Output

Returns the country, region, city, continent, and approximate latitude/longitude for the given IP address based on the DB-IP City Lite database. Private or reserved addresses (e.g. RFC 1918 ranges) are not charged and return no geolocation data.

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tollkit-ip-geolocation-48363a1c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from extract.tollkit.dev](https://www.zero.xyz/host/extract.tollkit.dev/llms.txt)