latestOpenAPI 3.0.2cPanel License2026-08-106251554.3 MB

3da41671c02c

DNS
Domain Management

Validate local server is authoritative

This function checks whether the local server has the authority to publish changes for the domain's DNS records.

Important:

When you disable the DNS role, the system disables this function.

get/has_local_authority

Query parameters

domainstring required

The domain to check whether the local server is authoritative for the domain's DNS records.

Note:

To check multiple domains, duplicate or increment the parameter name. For example, to check three domains, use the domain parameter multiple times. Or the domain, domain-1, and domain-2 parameters.

Response

HTTP Request was successful.

Example response

{
  "data": {
    "records": [
      {
        "domain": "example.com",
        "error": "(XID qdbmuk) DNS query (example3.com/SOA) timeout!",
        "local_authority": 1,
        "nameservers": [
          "ns1.example.com",
          "ns2.example.com"
        ],
        "zone": "example.com"
      }
    ]
  },
  "metadata": {
    "command": "has_local_authority",
    "reason": "OK",
    "result": 1,
    "version": 1
  }
}