WHOIS privacy API

Enable and disable WHOIS privacy on registered domains.

Note

Now you can enable WHOIS Privacy protection for any of your domains any time. As long as the domain is registered with us, and the TLD (Top Level Domain) supports WHOIS Privacy, the WHOIS Privacy service will stay enabled unless you disable it.

Retrieve the domain WHOIS privacy

Warning

This endpoint has been deprecated and removed. Use retrieve domain instead.

Enable WHOIS privacy

  PUT /:account/registrar/domains/:domain/whois_privacy

Enable the WHOIS privacy service.

Parameters

Name Type Description
:account integer The account id
:domain string, integer The domain name or id

Example

Enable WHOIS privacy for the domain example.com in the account 1010:

curl  -H 'Authorization: Bearer <token>' \
      -H 'Accept: application/json' \
      -X PUT \
      https://api.dnsimple.com/v2/1010/registrar/domains/example.com/whois_privacy

Response

Responds with HTTP 200 if WHOIS privacy is enabled.

Responds with HTTP 201 if WHOIS privacy is only enabled because it was purchased previously. Response available only on legacy domains.

{
  "data": {
    "id": 1,
    "domain_id": 2,
    "expires_on": "2017-02-13",
    "enabled": true,
    "created_at": "2016-02-13T14:34:50Z",
    "updated_at": "2016-02-13T14:36:48Z"
  }
}

Errors

Responds with HTTP 400 if WHOIS privacy cannot be enabled.

Responds with HTTP 401 in case of case of authentication issues.

Responds with HTTP 402 if the account has outstanding payments. Response available only on legacy domains.

Disable WHOIS privacy

  DELETE /:account/registrar/domains/:domain/whois_privacy

Disable the WHOIS privacy service.

Parameters

Name Type Description
:account integer The account id
:domain string, integer The domain name or id

Example

Disable WHOIS privacy for the domain example.com in the account 1010:

curl  -H 'Authorization: Bearer <token>' \
      -H 'Accept: application/json' \
      -X DELETE \
      https://api.dnsimple.com/v2/1010/registrar/domains/example.com/whois_privacy

Response

Responds with HTTP 200 if WHOIS privacy is disabled.

{
  "data": {
    "id": 1,
    "domain_id": 2,
    "expires_on": "2017-02-13",
    "enabled": false,
    "created_at": "2016-02-13T14:34:50Z",
    "updated_at": "2016-02-13T14:36:38Z"
  }
}

Errors

Responds with HTTP 400 if WHOIS privacy cannot be disabled.

Responds with HTTP 401 in case of case of authentication issues.

Renew WHOIS privacy

Warning

This endpoint has been deprecated and removed. WHOIS privacy no longer requires renewal.