pricing background

IP Whois Database Documentation

IP Whois Snapshot

Download IP Whois data snapshots in JSON‑gzipped format by specifying a date. Each snapshot provides complete Whois records, including IP ranges, contact details, and more in a structured format. Snapshot preparation typically takes 3–4 days.

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.
  • date
    Get a snapshot for a specific day by specifying the date parameter in yyyy‑MM‑dd format (e.g., 2026‑01‑26).

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200  Request is processed successfully.
Failure Codes
  • 400  Please pass apiKey param value.
  • 400  Please provide the date parameter
  • 400  Invalid date parameter
  • 400  Provided date is too old.
  • 401  Api record not found.
  • 401  Provided API key is inactive.
  • 401  Please buy database subscription.
  • 401  Your database subscription plan is inactive.
  • 401  You cannot download file.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 401  You have exceeded the download limit of 20000.
  • 401  Suspicious Activity.
  • 404  File is not available of this date.
  • 404  Resources are not available of this date.
  • 413  Please upgrade your plans.

IP WHOIS Snapshot Status

Use the endpoint to retrieve details of the latest IP WHOIS snapshot. The JSON output includes the snapshot name, creation date, and expected deletion date.

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.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200  Request is processed successfully.
Failure Codes
  • 400  Please pass apiKey param value.
  • 401  Api record not found.
  • 401  Provided API key is inactive.
  • 401  You cannot download file.
  • 401  Your account is deactivated.
  • 401  You have exceeded the download limit of 20000.
  • 401  Suspicious Activity.
  • 413  Please upgrade your plans.