pricing background

WHOIS API Documentation

Live Lookup

The WHOIS Domain API delivers structured JSON or XML data with registry and registrar details when available. It organizes ownership information into separate objects like registrant, technical, billing, and administrative details alongside nameservers and key domain dates such as registration and expiry. The WHOIS Domain API’s structured format ensures seamless integration into your systems.

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.

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...

Status Codes

Success Codes
  • 200  Request is processed successfully.
  • 206  Partial response, as an error occurred while processing the request.
  • 210  Cached response, as the WHOIS server failed to respond.
Failure Codes
  • 400  Please pass domain param correct value e.g. whoisfreaks.com, https://whoisfreaks.com, http://whoisfreaks.com
  • 401  Provided API key is invalid.
  • 401  Provided API key is inactive.
  • 401  Please buy a subscription plan or add api credits, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 403  We are not providing the whois of this domain extension (e.g., comsdf)
  • 403  Provided domain belongs to an inactive TLD. Please try to use historical whois lookup.
  • 408  Unable to fetch whois data. Please try again.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 500  Internal Server error occurred.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.

Historical Lookup

The WHOIS History API provides historical WHOIS data for domains, with multiple records stored in separate JSON or XML objects using a consistent format. The WHOIS History Lookup also retrieves live WHOIS data, excluding it when the latest record matches the current one.

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.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • whois
    The value of whois will be 'historical'.
  • 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...

Status Codes

Success Codes
  • 200  Request is processed successfully.
Failure Codes
  • 400  Please pass domain param correct value e.g. whoisfreaks.com, https://whoisfreaks.com, http://whoisfreaks.com
  • 401  Provided API key is invalid.
  • 401  Provided API key is inactive.
  • 401  Please buy a subscription plan or add api credits, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 404  Record not found.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 500  Internal Server error occurred.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.

Reverse Lookup

The Reverse WHOIS API allows searches across WHOIS records by email (registrant, billing, administrative, technical contacts), owner, keyword, or company. It supports pattern matching when the exact parameter is set to false. For instance, to find a keyword containing ‘end’ after ‘whois’, you can use 'whois*end'. The * (asterisk) represents any number of characters, making searches more flexible and powerful.

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.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • whois
    The value of whois will be 'reverse'.
  • keyword
    The domain keyword for requested whois.
  • email
    The email for requested WHOIS (exact or regex match).
  • owner
    The owner name for requested whois.
  • company
    The company name for requested whois.
Optional
  • mode
    Two modes are available mini & default.
  • exact
    The 'exact' parameter can be either 'true' or 'false'.
  • page
    For getting next or desired page of WHOIS info.
  • 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...

Status Codes

Success Codes
  • 200  Request is processed successfully.
Failure Codes
  • 400  Please provide correct value Param
  • 401  Provided API key is invalid.
  • 401  Provided API key is inactive.
  • 401  Please buy a subscription plan or add api credits, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 404  Record not found.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 500  Internal Server error occurred.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.

Bulk Domain Lookup

The Bulk WHOIS API performs live WHOIS lookups for up to 100 domains at once by submitting domain names in the body parameter. The Bulk WHOIS API also supports file uploads with up to 3 million entries (one domain per line), with results sent directly to the user via email.

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.

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...

Status Codes

Success Codes
  • 200  Request is processed successfully.
  • 206  Partial response, as an error occurred while processing the request.
  • 210  Cached response, as the WHOIS server failed to respond.
Failure Codes
  • 400  Please provide domainNames in request body.
  • 401  Provided API key is invalid.
  • 401  Provided API key is inactive.
  • 401  Please buy a subscription plan or add api credits, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 403  We are not providing the whois of this domain extension (e.g., comsdf)
  • 403  Provided domain belongs to an inactive TLD. Please try to use historical WHOIS lookup.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  The requested list size is [GREATER_THAN_100] which exceeds the maximum list size of 100.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 500  Internal Server error occurred.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.