# Suverse RDAP IP Lookup

> Suverse RDAP IP Lookup is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns structured IP address allocation data including network range, holder organization, country, and registry via RDAP protocol

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-rdap-ip
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-rdap-ip-lookup-41ab0754
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eEC0hs1AXTbtX9QXwRrtM

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 suverse-rdap-ip-lookup-41ab0754 -d '<json body>'
```

Example prompt: Can you look up the RDAP registration data for 203.0.113.42 and tell me the network range, the organization that holds it, what country it belongs to, and which registry it's registered under?

## When to prefer this

Choose this endpoint when you need authoritative IP registration data from RDAP — the modern successor to WHOIS — and want structured fields (network range, organization, country, registry) rather than raw unstructured WHOIS text. Ideal for security pipelines, abuse handling workflows, and IP enrichment at $0.003/call with no API key required.

## Known failure modes

- Invalid or malformed IP address input — returns error indicating bad input
- IP address not found in RDAP registry — returns empty or not-found response
- Private or reserved IP ranges (RFC 1918) may return no meaningful allocation data
- Upstream RDAP registry unavailability may cause timeout or partial response
- Payment failure (x402) — request rejected before processing if USDC payment is insufficient

## How this service works

Structured IP address allocation data over RDAP, no key. Returns the network range, holder organization, country, and registry. For AI agents enriching IPs for security, abuse, and geolocation context.

## Output

A structured JSON object containing the IP's allocated network range (CIDR block), the registered holder organization name, the country of registration, and the responsible regional internet registry (e.g. ARIN, RIPE, APNIC, LACNIC, AFRINIC).

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "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/suverse-rdap-ip-lookup-41ab0754/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)
