# IP to Country Lookup (Registry-Based)

> IP to Country Lookup (Registry-Based) is a paid API for AI agents from intel.rallylive.ca, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns the country an IPv4 address is registered to based on regional internet registry (RIR) data via Team Cymru and RDAP, along with ASN context — not a geo-IP database.

## Facts

- Endpoint: GET https://intel.rallylive.ca/ip/geo
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ip-to-country-lookup-registry-based-1d2de995
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MQhN_QQ_Vr4xWPBpCl2SY

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 ip-to-country-lookup-registry-based-1d2de995
```

Example prompt: What country is the IP address 203.0.113.42 registered to? I need the official registry data and ASN context, not a geo-IP database estimate.

## When to prefer this

Choose this endpoint when you need authoritative, registry-sourced country and ASN data for an IPv4 address without relying on a commercial geo-IP database. It is ideal for compliance, fraud screening, or network intelligence use cases where the distinction between registry allocation and physical geolocation matters. Prefer it over geo-IP databases when transparency and accuracy of source data are required, or when you want to avoid database licensing costs beyond a per-query fee.

## Known failure modes

- Invalid or malformed IPv4 address returns an error
- Private/reserved IP ranges (e.g. 10.x.x.x, 192.168.x.x) may return no country or a special designation
- IPv6 addresses are not supported (endpoint is IPv4-only)
- Some IPs may have sparse or missing RIR data resulting in incomplete response
- Payment failure (x402) if USDC balance is insufficient

## How this service works

IP to country: the country an IPv4 address is registered to, from the regional internet registry (via Team Cymru and RDAP), with ASN context. Honest about what it is: registry data, not precise geolocation, and free of any keyed geo-IP database. $0.01 per IP.

## Output

Returns the country the IPv4 address is registered to according to regional internet registry (RIR) records sourced from Team Cymru and RDAP, along with ASN (Autonomous System Number) context. The response is explicit that this reflects registry allocation data, not precise geolocation from a commercial geo-IP database.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ip-to-country-lookup-registry-based-1d2de995/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from intel.rallylive.ca](https://www.zero.xyz/host/intel.rallylive.ca/llms.txt)