SoonOne MCP server, all 49 APIs as agent tools. See how it works

Comprehensive domain information retrieval for developers

Whois Lookup API

The Whois Lookup API provides developers with instant access to comprehensive domain registration information. Query any domain to retrieve registrant details, registrar information, domain dates, and nameservers in a structured JSON format.

Perfect for domain research, cybersecurity analysis, brand protection, and compliance verification. The API handles multiple TLD formats and provides consistent, reliable data from authoritative whois servers worldwide.

Free tier included, no credit card required. One key works across all 49 APIs.

At a glance
Domain TLDs
500+
Response Time
<2s
Data Accuracy
99.9%

Key features

  • Real-time whois data from authoritative servers
  • Support for 500+ domain extensions
  • Registrant and registrar information
  • Domain creation, expiration, and update dates
  • Nameserver and DNS information
  • Domain status and lock information
  • Structured JSON response format

Built for

  • Domain research and analysis
  • Cybersecurity threat intelligence
  • Brand protection monitoring
  • Compliance and due diligence
  • Domain portfolio management
  • Legal and trademark research
  • Website acquisition research
  • Domain expiration monitoring

Try it

Build the request for your data

Edit the parameters below and see the exact curl command and JSON response you will get. No key required to preview.

GET/v1/whois
Open in Playground

Parameters

Request · HTTP
GET /rdap/v1/whois?domain=example.com HTTP/1.1
Host: api.apicodex.io
Response · JSON
200 OK
{
"domain": "example.com",
"registrar": "Example Registrar Inc.",
"registrant_name": "Example Organization",
"registrant_email": "admin@example.com",
"creation_date": "1995-08-14",
"expiration_date": "2025-08-13",
"updated_date": "2024-07-12",
"nameservers": [
  "ns1.example.com",
  "ns2.example.com"
],
"status": ["clientTransferProhibited"]
}

Documentation

Whois Lookup API Documentation

The Whois Lookup API provides comprehensive access to domain registration information from authoritative whois servers worldwide. Query any domain to retrieve registrant details, registrar information, domain dates, nameservers, and domain status in a structured JSON format.

Base URL

url
https://api.apicodex.io/rdap

Authentication

Authenticate every request with your API key: send it in an X-Api-Key header, or pass it as an ?apikey= query parameter.

headers
{
"X-Api-Key": "YOUR_API_KEY"
}

Request and response

Illustrative values. Confirm current endpoint behavior, quotas, and data freshness in the API documentation before production use.

request · http
GET /v1/whois?domain=example.com HTTP/1.1
response · json
{
"domain": "example.com",
"registrar": "Example Registrar Inc.",
"registrant_name": "Example Organization",
"registrant_email": "admin@example.com",
"creation_date": "1995-08-14",
"expiration_date": "2025-08-13",
"updated_date": "2024-07-12",
"nameservers": [
  "ns1.example.com",
  "ns2.example.com"
],
"status": ["clientTransferProhibited"]
}

Code examples

JavaScript/Node.js
const axios = require('axios');

const options = {
  method: 'GET',
  url: 'https://api.apicodex.io/rdap/v1/whois',
  params: {domain: 'example.com'},
  headers: {
    'X-Api-Key': 'YOUR_API_KEY'
  }
};

try {
  const response = await axios.request(options);
  console.log(response.data);
} catch (error) {
  console.error(error);
}

Pricing

Whois Lookup API Pricing

One key, one subscription, all 49 APIs. Start free and upgrade when you grow. No minimums, no lock-in.

This API costs 5 credits per request. Credits are shared across every API on your plan.

Estimate your monthly cost

Drag the slider to match your expected request volume. We will recommend the cheapest plan that covers it.

10,000

Recommended plan

Starter

$29.99 /month

Credits used50,000
Credits included50,000
Cost per 1K requests$2.999
Choose Starter

Free

Free
1,000 credits · ~200 requests/mo · 2 rps
  • All 49 APIs included
  • No credit card required
  • Full documentation and examples
Start for free

Starter

Popular
$29.99/month
50,000 credits · ~10,000 requests/mo · 10 rps
  • All 49 APIs included
  • Email support
  • Usage dashboard and analytics
Start with Starter

Pro

$99.99/month
250,000 credits · ~50,000 requests/mo · 25 rps
  • All 49 APIs included
  • Priority support
  • Up to 5 API keys
Start with Pro

Need a different plan?

Tell us about your API, volume, or support requirements.

Contact us

Coming soon · MCP

Use the Whois Lookup API from your AI agent

The API Codex MCP server will expose this API, and the other 39, to Claude, Cursor and any MCP client as tools. Same key, same credits, one config entry.

About the MCP server

FAQ

Frequently asked questions

The Whois Lookup API returns a comprehensive set of domain registration data in structured JSON format. This includes the registrant organization name and contact details, the sponsoring registrar name and IANA ID, domain creation date, last-updated date, and expiration date, as well as the authoritative nameservers assigned to the domain. You also receive EPP status codes such as clientTransferProhibited or serverDeleteProhibited, which indicate the current lock state of the domain. The API normalizes data across different registrar formats, so you receive a consistent schema regardless of the underlying WHOIS server protocol or TLD-specific variations.

Yes, the API supports lookups for over 500 top-level domain extensions, including generic TLDs like .com, .net, .org, and .info, country-code TLDs such as .co.uk, .de, .fr, .jp, and .au, as well as newer gTLDs like .io, .dev, .app, and .xyz. Behind the scenes, the API automatically routes your query to the correct authoritative WHOIS server for each TLD and parses the response into a consistent JSON schema. This means you do not need to maintain a mapping of WHOIS servers yourself or handle the varied text-based output formats that different registries produce.

The API performs live queries against the authoritative WHOIS servers for each domain at the time of your request, so data is always real-time. There is no stale cache layer between your request and the registry source. This means that recent changes to registrant information, nameserver updates, domain transfers, or EPP status modifications are reflected immediately. For domains that have transitioned to the newer RDAP protocol, the API seamlessly queries the RDAP endpoint instead, which offers structured JSON natively and is the ICANN-recommended successor to the traditional WHOIS text protocol.

When a domain owner enables privacy protection (also called WHOIS proxy or privacy guard) through their registrar, the registrant contact fields in the WHOIS record are replaced with the proxy service's information instead of the actual owner's personal details. The API will return whatever data the authoritative WHOIS server provides, so privacy-protected domains will show the proxy organization name, a generic forwarding email, and the proxy service address. However, key technical fields such as nameservers, domain status codes, creation and expiration dates, and the sponsoring registrar remain fully visible regardless of privacy settings, since these are maintained by the registry itself.

WHOIS is the original domain registration query protocol defined in RFC 3912, which returns unstructured plain-text responses with no standardized format across registries. RDAP (Registration Data Access Protocol), defined in RFC 7480-7484, is the modern replacement endorsed by ICANN that returns structured JSON responses with built-in support for internationalization, authenticated access, and differentiated access control. Our API abstracts this complexity entirely: it detects whether a TLD supports RDAP and automatically uses the appropriate protocol, then normalizes the output into a single consistent JSON schema. You get the benefits of RDAP coverage and accuracy without needing to implement either protocol yourself.

Absolutely. The Whois API is widely used for brand protection workflows such as monitoring newly registered domains that contain your brand name or trademark, detecting typosquatting variations that could be used for phishing campaigns, and tracking expiration dates on domains in your portfolio to prevent accidental lapses. By polling the API on a scheduled basis, you can build automated alerting systems that notify your legal or security team when suspicious domains appear. The structured JSON output integrates easily with SIEM platforms, ticketing systems, and custom dashboards, enabling you to incorporate domain intelligence directly into your existing security operations pipeline.