Piloterr

Domain Whois

Retrieve WHOIS registration data for any domain, including registration dates, registrar details, name servers, and contact information.

Credit cost: 1 credit per call

GET
/v2/domain/whois

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

A domain name for which you want to retrieve WHOIS registration information.

Example:

piloterr.com

The API returns full WHOIS data including domain registration dates, registrar details, name servers, and contact information (where not redacted for privacy).

Note: Privacy protection (GDPR redaction) may hide registrant details for many domains.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/domain/whois?query=string"
{
  "domain": {
    "id": "2236981934_DOMAIN_COM-VRSN",
    "name": "piloterr",
    "domain": "piloterr.com",
    "status": [
      "clientdeleteprohibited",
      "clienttransferprohibited"
    ],
    "punycode": "piloterr.com",
    "extension": "com",
    "created_date": "2018-03-08T23:08:14Z",
    "name_servers": [
      "cruz.ns.cloudflare.com",
      "fred.ns.cloudflare.com"
    ],
    "updated_date": "2023-06-22T07:40:14Z",
    "whois_server": "whois.ovh.com",
    "expiration_date": "2030-03-08T23:08:14Z",
    "created_date_in_time": "2018-03-08T23:08:14Z",
    "updated_date_in_time": "2023-06-22T07:40:14Z",
    "expiration_date_in_time": "2030-03-08T23:08:14Z"
  },
  "registrar": {
    "id": "433",
    "name": "OVH sas",
    "email": "abuse@ovh.net",
    "phone": "+33.972101007",
    "referral_url": "https://www.ovh.com"
  },
  "technical": {
    "fax": "REDACTED FOR PRIVACY",
    "city": "REDACTED FOR PRIVACY",
    "name": "REDACTED FOR PRIVACY",
    "email": "REDACTED FOR PRIVACY",
    "phone": "REDACTED FOR PRIVACY",
    "street": "REDACTED FOR PRIVACY",
    "country": "REDACTED FOR PRIVACY",
    "organization": "REDACTED FOR PRIVACY"
  },
  "registrant": {
    "fax": "REDACTED FOR PRIVACY",
    "city": "REDACTED FOR PRIVACY",
    "name": "REDACTED FOR PRIVACY",
    "email": "REDACTED FOR PRIVACY",
    "phone": "REDACTED FOR PRIVACY",
    "street": "REDACTED FOR PRIVACY",
    "country": "FR"
  },
  "administrative": {
    "fax": "REDACTED FOR PRIVACY",
    "city": "REDACTED FOR PRIVACY",
    "name": "REDACTED FOR PRIVACY",
    "email": "REDACTED FOR PRIVACY",
    "phone": "REDACTED FOR PRIVACY",
    "country": "REDACTED FOR PRIVACY",
    "organization": "REDACTED FOR PRIVACY"
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}