Making requests

Our Hosted Bulk WHOIS Web Service provides registration details, also known as WHOIS Records, of domain names or IP addresses.

Bulk WHOIS API provides WHOIS records for a list of Domains/IPs via a single REST API query. It is designed for server-to-server communication between your system and the WhoisXMLAPI.com network using standard HTTP or HTTPS protocols. Query responses are delivered in either XML or JSON format based on your requests which are made via POST methods.

To get started you need an account with WhoisXMLAPI.com. Authentication is required each time in order to use the API. The first 500 Bulk WHOIS API credits are complimentary when you register for a free account.

Postman collection

Postman is a desktop and web application that allows you to make requests to an API from a graphical user interface. We recommend using Postman with WhoisXML APIs endpoints when exploring the APIs functionality, as well as when you are troubleshooting issues with your application.

The WhoisXML API Postman collection is available at the following links:

The collection includes a preconfigured environment. You will need to set up the api_key variable to fire each request. Get your personal API KEY on the My products page. If you have questions related to the API, contact us.

Create a new request

POST https://www.whoisxmlapi.com/BulkWhoisLookup/bulkServices/bulkWhois

In order to check lists of domains with the Bulk API, first upload the terms to the server which will create a request and return its ID to you. Then you can use this ID to query the request's status, download results etc.

Note that the results are stored for 1 year.

POST request body sample

{
    "apiKey": "API_KEY",
    "domains": [
        "google.com",
        "yahoo.com"
    ],
    "outputFormat": "JSON"
}

Input parameters

apiKey

Required. Get your personal API key on the My products page.

domains

Required. Array.

An array of domains for which WHOIS data is requested.

outputFormat

Optional. Response output format.

Acceptable values: JSON | XML

Default: XML

Sample output

{
    "noDataAvailable": false,
    "message": "OK",
    "messageCode": 200,
    "requestId": "ece0f949-c22a-4ecc-..."
}

Code: 200 OK.

Output parameters

noDataAvailable

Boolean.

Indicates whether WHOIS data is available for the requested domain.

message

String.

Response message.

messageCode

Integer.

Response message code.

requestId

String.

Request ID.