WHOIS Lookup
Get domain registration details including registrar, name servers, status, creation and expiry dates, and DNSSEC information.
Overview
Use Cases
- Verifying domain ownership before initiating a transfer
- Checking domain expiry dates for monitoring or alerting
- Enriching lead data with registrar and registration details
- Security research and phishing domain investigation
Features
Registrar name and WHOIS server
Name servers list
Domain status flags (e.g. clientTransferProhibited)
Creation, updated, and expiry dates
DNSSEC status
API Endpoints
WHOIS Lookup
Returns WHOIS registration information for a domain name.
GET
https://api.requiems.xyz/v1/tech/whois/{domain}
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| domain | string |
Required | The domain name to look up (e.g. example.com) |
Try it out
Live DemoRequest
The domain name to look up (e.g. example.com)
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| domain | string |
The domain name that was looked up |
| registrar | string |
The name of the registrar holding the domain registration |
| name_servers | array of strings |
List of authoritative name servers for the domain |
| status | array of strings |
EPP status codes for the domain (e.g. clientTransferProhibited) |
| created_date | string |
Date the domain was first registered (ISO 8601) |
| updated_date | string |
Date the domain record was last updated (ISO 8601) |
| expiry_date | string |
Date the domain registration expires (ISO 8601) |
| dnssec | boolean |
True when DNSSEC is enabled for the domain |
Code Examples
curl "https://api.requiems.xyz/v1/tech/whois/example.com" \
-H "requiems-api-key: YOUR_API_KEY"import requests
url = "https://api.requiems.xyz/v1/tech/whois/example.com"
headers = {"requiems-api-key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())const response = await fetch('https://api.requiems.xyz/v1/tech/whois/example.com', {
headers: { 'requiems-api-key': 'YOUR_API_KEY' }
});
const data = await response.json();
console.log(data.data.registrar, data.data.expiry_date);require 'net/http'
require 'json'
uri = URI('https://api.requiems.xyz/v1/tech/whois/example.com')
request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
data = JSON.parse(response.body)
puts data['data']['registrar']Error Responses
bad_request
The domain name format is invalid.
not_found
No WHOIS record was found for the domain.
internal_error
Unexpected server error or upstream WHOIS query failure.
Frequently Asked Questions
Any publicly registered domain with a WHOIS server is supported. This includes all common TLDs (.com, .net, .org, .io, etc.) and most country-code TLDs (ccTLDs).
WHOIS data availability depends on the registry and registrar policies. Many registrars redact personal contact information under GDPR or similar privacy regulations. Fields will be omitted from the response when not available.
A 404 not_found response means the domain is either unregistered or the registry returned no data for it.
WHOIS data is fetched live from the authoritative WHOIS servers on each request. There is no caching layer, so the data reflects the current state of the registry.