# WHOIS API
> Domain and IP registration lookups via RDAP — the modern, structured successor to WHOIS. Get the registrar, registration / update / expiry dates, status codes, nameservers, DNSSEC state, and IP network ownership (CIDR, organization, country).

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/whois-api/..."
```

## Pricing
- **Free** (Free) — 750 calls/Mo, 1 req/s
- **Basic** ($10/Mo) — 35,000 calls/Mo, 5 req/s
- **Pro** ($39/Mo) — 200,000 calls/Mo, 15 req/s
- **Mega** ($119/Mo) — 850,000 calls/Mo, 40 req/s

## Endpoints

### WHOIS

#### `GET /v1/domain` — Domain registration lookup

**Parameters:**
- `domain` (query, required, string) — Domain name Example: `google.com`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/whois-api/v1/domain?domain=google.com"
```

**Response:**
```json
{
    "data": {
        "dnssec": false,
        "domain": "google.com",
        "handle": "2138514_DOMAIN_COM-VRSN",
        "status": [
            "client delete prohibited",
            "client transfer prohibited",
            "client update prohibited",
            "server delete prohibited",
            "server transfer prohibited",
            "server update prohibited"
        ],
        "created": "1997-09-15T04:00:00Z",
        "expires": "2028-09-14T04:00:00Z",
        "updated": "2019-09-09T15:39:04Z",
        "registrar": "MarkMonitor Inc.",
        "registrant": null,
        "nameservers": [
            "ns1.google.com",
            "ns2.google.com",
            "ns3.google.com",
            "ns4.google.com"
        ]
    },
    "meta": {
        "timestamp": "2026-05-29T23:00:27.535Z",
        "request_id": "ec34f11c-859b-404b-a7d0-524ee220963e"
    },
    "status": "ok",
    "message": "Domain lookup retrieved successfully",
    "success": true
}
```

#### `GET /v1/ip` — IP network registration lookup

**Parameters:**
- `ip` (query, required, string) — IPv4 or IPv6 address Example: `8.8.8.8`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/whois-api/v1/ip?ip=8.8.8.8"
```

**Response:**
```json
{
    "data": {
        "org": "Google LLC",
        "cidr": "8.8.8.0/24",
        "name": "GOGL",
        "type": "DIRECT ALLOCATION",
        "handle": "NET-8-8-8-0-2",
        "status": [
            "active"
        ],
        "country": null,
        "ip_version": "v4",
        "end_address": "8.8.8.255",
        "start_address": "8.8.8.0"
    },
    "meta": {
        "timestamp": "2026-05-29T23:00:28.834Z",
        "request_id": "6c43f101-4cbc-4252-9bdf-0792fa4c8866"
    },
    "status": "ok",
    "message": "IP lookup retrieved successfully",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/whois-api
OpenAPI spec: https://www.oanor.com/api/whois-api/openapi.json