pricing background

Live Whois API Documentation

Live Whois API

ASK AI
The Live WHOIS Lookup API fetches current domain registration data directly from authoritative WHOIS servers and RDAP in real time - no caching, no database dependency. Every request returns a fully parsed, normalised response containing registrar details, registrant and contact objects, creation and expiry dates, nameservers, domain status codes, and the raw WHOIS text in JSON or XML.

Authorization

You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.

Important References

  • For details on request limits and handling rate limiting, refer here
  • For a complete overview of API credit consumption and usage, refer here

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • whois
    The value of whois will be 'live'.
  • domainName
    The domainName for requested whois.
Optional
  • format
    Two formats are available JSON, XML. If you don't specify the 'format' parameter, the default format will be JSON.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Fields Description

Fields
Details
Data Type
Example
status
Indicates if the request was successful
boolean
true
domain_name
Registered domain name
string
example.com
query_time
Timestamp when the WHOIS query was executed
string (YYYY-MM-DDTHH:mm:ssZ)
2026-04-14T10:30:00Z
whois_server
WHOIS server used for the query
string
whois.example-registrar.com
domain_registered
Indicates whether the domain is registered
string
yes
secure_dns
Indicates if DNSSEC or secure DNS is enabled
boolean
true
domain_handle
Internal domain registry handle/ID
string
D123456789
create_date
Domain creation date
string (YYYY-MM-DD)
2010-05-10
update_date
Last update date of the domain record
string (YYYY-MM-DD)
2025-03-01
expiry_date
Domain expiration date
string (YYYY-MM-DD)
2030-05-10
domain_registrar
Registrar information for the domain
id
Registrar identifier
string
123
id_type
Type of registrar ID
string
IANA
iana_id
IANA assigned registrar ID
string
9999
registry_id
Registry-specific registrar ID
string
reg-123
handle
Registrar handle
string
REG-HANDLE-1
status
Registrar status
string
active
registrar_name
Name of the registrar
string
Example Registrar Inc.
normalized_name
Normalized registrar name
string
example registrar
whois_server
Registrar WHOIS server
string
whois.example-registrar.com
rdap_server
RDAP server URL
string
https://rdap.example-registrar.com
website_url
Registrar website URL
string
https://www.example-registrar.com
email_address
Registrar support email
string
phone_number
Registrar contact number
string
+1-800-123-4567
authoritative_registry_name
Registry authority name
string
Example Registry
organization_number
Registrar organization number
string
ORG-001
is_sponsor
Indicates if registrar is sponsor
boolean
true
reseller_contact
Reseller contact details
name
Reseller name
string
Example Reseller
email_address
Reseller email
string
phone
Reseller phone number
string
+1-800-765-4321
registrant_contact
Domain registrant contact details
id
Contact ID
string
C001
name
Registrant name
string
John Doe
company
Registrant company
string
Example Corp
street
Street address
string
123 Main Street
city
City
string
New York
state
State/Province
string
NY
zip_code
ZIP/Postal code
string
10001
country_name
Country name
string
United States
country_code
Country code
string
US
email_address
Contact email
string
phone
Contact phone
string
+1-555-1234
administrative_contact
Administrative contact details
name
Admin name
string
Jane Smith
email_address
Admin email
string
technical_contact
Technical contact details
name
Technical contact name
string
Tech Support
email_address
Technical email
string
billing_contact
Billing contact details
name
Billing department name
string
Billing Dept
email_address
Billing email
string
eligibility_info
Domain eligibility information
id
Eligibility ID
string
ELIG-001
name
Eligibility name
string
Standard Eligibility
type
Eligibility type
string
business
abuse_contact
Abuse contact information
email_address
Abuse contact email
string
phone_number
Abuse contact phone
string
+1-800-999-9999
name_servers
List of domain name servers
array
ns1.example.com
domain_status
Current domain status flags
array
active
whois_raw_domain
Raw WHOIS response for the domain
string
registry_data
Registry-level WHOIS data
domain_name
Domain name from registry
string
example.com
query_time
Registry query timestamp
string (YYYY-MM-DDTHH:mm:ssZ)
2026-04-14T10:30:00Z
whois_server
Registry WHOIS server
string
whois.registry-example.com
create_date
Registry creation date
string (YYYY-MM-DD)
2010-05-10
update_date
Registry update date
string (YYYY-MM-DD)
2025-03-01
expiry_date
Registry expiry date
string (YYYY-MM-DD)
2030-05-10
domain_registrar
Registrar data from registry
name_servers
Name servers from registry
array
ns1.example.com
domain_status
Domain status from registry
array
active
whois_raw_registery
Raw registry WHOIS response
string
RAW REGISTRY WHOIS DATA HERE