---
title: "Registration data: registrar, dates, status, nameservers (RDAP, WHOIS fallback)"
method: GET
path: "/api/v1/domain/{domain}/whois"
tags: ["Domains"]
---

# Registration data: registrar, dates, status, nameservers (RDAP, WHOIS fallback)

`GET /api/v1/domain/{domain}/whois`

## Request

- Base URL: `https://www.tlders.com`
- URL: `https://www.tlders.com/api/v1/domain/{domain}/whois`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `domain` string, required

## Response `200`

OK

- object
  - `data` Whois
    - `domain` string
    - `registered` boolean, nullable
    - `source` 'rdap' | 'whois' | 'null', nullable
    - `registrar` string, nullable
    - `createdAt` string, nullable
    - `updatedAt` string, nullable
    - `expiresAt` string, nullable
    - `daysUntilExpiry` integer, nullable
    - `status` string[]
    - `nameservers` string[]
    - `dnssec` boolean, nullable
    - `raw` string, nullable: Raw port-43 reply when WHOIS answered

## Other responses

- `400`: A required parameter is missing or invalid
- `401`: Missing, invalid or revoked API key
- `402`: Endpoint needs a paid plan (free keys: 100 requests/month, no bulk /prices)
- `429`: Daily request limit exceeded (see Retry-After)

---

[API](https://skmtc.dev/tlders/apis/tlders-domain-pricing-api.md) · [All operations](https://skmtc.dev/tlders/apis/tlders-domain-pricing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tlders/apis/tlders-domain-pricing-api/revisions/d24ebbcf6fd2?raw)