---
title: "WHOIS/RDAP lookup for a domain"
method: POST
path: "/api/tools/whois"
---

# WHOIS/RDAP lookup for a domain

`POST /api/tools/whois`

## Request

- Base URL: `https://name.ai`
- URL: `https://name.ai/api/tools/whois`
- Auth: none declared

Looks up registrar, registrant, creation/expiration dates, and nameservers via RDAP (falling back to DomainIQ). Rate-limited to 10 lookups/day per caller IP for anonymous callers.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `domain` string, required

## Response `201`

Lookup succeeded. Deprecation/Sunset/Link headers appear only once the operation is deprecated (see x-deprecation-policy).

- object
  - `lookup` object
    - `id` string, nullable
    - `domain` string
    - `result` object
      - `domain` string
      - `status` string
      - `registrar` string
      - `registrant` string
      - `creation_date` string
      - `expiration_date` string
      - `update_date` string
      - `nameservers` string[]
      - `emails` string[]
      - `raw_source` 'RDAP' | 'DomainIQ'
    - `created_at` string, date-time
  - `used` integer
  - `cap` integer
  - `remaining` integer

## Other responses

- `400`: Invalid domain name.
- `404`: WHOIS data unavailable for this domain.
- `429`: Daily lookup quota exceeded (10/day per IP for anonymous callers).

---

[API](https://skmtc.dev/name/apis/name-ai-api-public-rest-api-openapi-3-1.md) · [All operations](https://skmtc.dev/name/apis/name-ai-api-public-rest-api-openapi-3-1/llms.txt) · [OpenAPI document](https://skmtc.dev/name/apis/name-ai-api-public-rest-api-openapi-3-1/revisions/e04300069786?raw)