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
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
[email protected]
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
[email protected]
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
[email protected]
phone
Contact phone
string
+1-555-1234
administrative_contact
Administrative contact details
name
Admin name
string
Jane Smith
email_address
Admin email
string
[email protected]
technical_contact
Technical contact details
name
Technical contact name
string
Tech Support
email_address
Technical email
string
[email protected]
billing_contact
Billing contact details
name
Billing department name
string
Billing Dept
email_address
Billing email
string
[email protected]
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
[email protected]
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