CPcpanel
DNS
DNS Information

Return whether domains use recognized nameservers

Changed on

This function indicates whether the account's domains' nameservers resolve to an IP address that this server recognizes as its own. It predicts the outcome of the create-time nameserver validation that runs when a domain is added to the account, without performing any privileged action.

get/DNS/ensure_domains_use_recognized_nameservers

Request

  • Base URL
    https://cpanel-server.tld:2083/execute
  • Auth
    HTTP basic

Query parameters

domainstring domain required
Example:example1.com

The domain to check.

Note:

To check multiple domains, duplicate or increment the parameter name. For example, to check three domains, you could:

  • Use the domain parameter multiple times.
  • Use the domain, domain-1, and domain-2 parameters.

Response

HTTP Request was successful.

apiversioninteger

The version of the API.

funcstring

The name of the method called.

modulestring

The name of the module called.

Example response

{
  "apiversion": 3,
  "func": "ensure_domains_use_recognized_nameservers",
  "module": "DNS",
  "result": {
    "data": [
      {
        "message": "The system cannot use the domain \"example.com\" because its registered nameservers are not associated with this server.",
        "type": "unrecognized_nameservers"
      }
    ],
    "metadata": {
      "transformed": 1
    },
    "status": 1
  }
}

Changes