pricing background

Bulk Whois API Documentation

Bulk WHOIS API

ASK AI
The Bulk WHOIS API gives you two ways to process domains at scale. For real-time pipeline integration, submit up to 100 domains in a single POST request and receive a full structured WHOIS record for each registrar and registrant contacts, dates, name servers, and status codes in the same normalized format as the single-domain live WHOIS API. Domain names are submitted as a JSON array in the request body.
For larger batch jobs, use the file upload mode and upload a plain text file with one domain per line and process up to 3 million domains in a single job. Results are delivered as a compressed CSV to your registered email address when processing completes.

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