# ipv4.fr IP Geolocation API

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

Returns geolocation data (city, country, ISP) for a given IPv4 address

## Facts

- Endpoint: GET https://ipv4.fr/x402/v1/geo/%7Bip%7D?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ipv4-fr-ip-geolocation-api-439b6584
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-_OCEj2ROjdPQ2MIqz8wV

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 ipv4-fr-ip-geolocation-api-439b6584
```

Example prompt: Can you look up the geolocation for IP address 203.0.113.45 and tell me which city, country, and ISP it belongs to?

## When to prefer this

Choose this endpoint when you need fast, low-cost IP geolocation with ISP identification for a single IPv4 address, especially when paying per-call via x402/USDC is acceptable. It is well-suited for enriching logs, fraud detection pipelines, or any workflow where you need city-level location and ISP data without a subscription.

## Known failure modes

- Invalid IP address format returns an error
- Private/reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) may return no geolocation data
- Payment failure (402) if USDC balance is insufficient
- IPv6 addresses may not be supported given the endpoint path prefix 'ipv4'
- Rate limiting if free tier quota is exceeded

## How this service works

Fast, reliable network tools API. IP geolocation, DNS lookup, SSL check, WHOIS, email validation, port scan. Free tier available.

## Output

A JSON object containing the queried IP address, the ISP name, the city, and the ISO country code (e.g. {"ip":"8.8.8.8","isp":"Google LLC","city":"Ashburn","country_code":"US"})

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ip": "8.8.8.8",
  "isp": "Google LLC",
  "city": "Ashburn",
  "country_code": "US"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ipv4-fr-ip-geolocation-api-439b6584/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ipv4.fr](https://www.zero.xyz/host/ipv4.fr/llms.txt)