# IPstack IP Geolocation Lookup

> IPstack IP Geolocation Lookup is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.08/call, status unknown (last checked 2026-09-15).

Returns geolocation and metadata for a given IPv4 or IPv6 address, including country, region, city, timezone, and ISP information.

## Facts

- Endpoint: GET https://gateway.apiosk.com/ipstack/134.201.250.155
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ipstack-ip-geolocation-lookup-1c3ef0bd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cbgQD3xkvgevtfaq6llL3

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 ipstack-ip-geolocation-lookup-1c3ef0bd
```

Example prompt: Can you look up the geolocation details for IP address 134.201.250.155 — I need the country, city, region, latitude, longitude, and timezone.

## When to prefer this

Use this endpoint when you need fast, structured geolocation and network metadata for a single IPv4 or IPv6 address. Prefer it over generic geo APIs when you also need ISP, connection type, timezone, or currency data in a single call. Best suited for per-request IP enrichment workflows where paying per-call via x402 is acceptable.

## Known failure modes

- Invalid IP address format returns an error code and message
- Private or reserved IP ranges (e.g. 192.168.x.x) may return incomplete or null geolocation data
- Rate limit exceeded returns a 429 or API-level error
- Unrecognized or newly allocated IPs may return partial data
- Payment not processed results in a 402 response before the lookup is performed

## How this service works

Lookup a specific IPv4 or IPv6 address. Append the IP to the path, for example /134.201.250.155. Use fields to limit the response to only the metadata an agent needs.

## Output

Returns a JSON object with geolocation data for the queried IP address, including country name and code, region, city, zip code, latitude, longitude, timezone details, ISP name, connection type, and optionally currency and language information.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ipstack-ip-geolocation-lookup-1c3ef0bd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.apiosk.com](https://www.zero.xyz/host/gateway.apiosk.com/llms.txt)
