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.
- 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.
Parameters
GET /rdap/v1/whois?domain=example.com HTTP/1.1
Host: api.apicodex.io
{
"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
https://api.apicodex.io/rdapAuthentication
Authenticate every request with your API key: send it in an X-Api-Key header, or pass it as an ?apikey= query parameter.
{
"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.
GET /v1/whois?domain=example.com HTTP/1.1{
"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
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.
Recommended plan
Starter
$29.99 /month
Free
- All 49 APIs included
- No credit card required
- Full documentation and examples
Starter
Popular- All 49 APIs included
- Email support
- Usage dashboard and analytics
Pro
- All 49 APIs included
- Priority support
- Up to 5 API keys
Need a different plan?
Tell us about your API, volume, or support requirements.
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.
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.
Keep building