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
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringA domain name for which you want to retrieve WHOIS registration information.
Example:
piloterr.comThe 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.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
domain?registrar?technical?registrant?administrative?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" }}