# Validate local server is authoritative

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



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

Endpoint: GET /has_local_authority
Version: 11.134.0.5
Security: BasicAuth

## Query parameters:

  - `domain` (string, required)
    The domain to check whether the local server is authoritative for the domain's DNS records.



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

## Response 200 fields (application/json):

  - `data` (object)

  - `data.records` (array)
    An array of objects that contains information about about the authoritative status of a domain's local DNS zone files.

  - `data.records.domain` (string)
    The queried domain.
    Example: "example.com"

  - `data.records.error` (string)
    A message that details the reason why the local server's authoritative check failed.



 The function  returns this value when the check fails.
    Example: "(XID qdbmuk) DNS query (example3.com/SOA) timeout!"

  - `data.records.local_authority` (integer)
    Whether the local server is authoritative for the domain's DNS records.
*  — The local server is authoritative for the domain's DNS records.
*  — The local server is  authoritative for the domain's DNS records.
    Enum: 0, 1

  - `data.records.nameservers` (array)
    The domain's authoritative nameservers, if any exist.
    Example: ["ns1.example.com","ns2.example.com"]

  - `data.records.zone` (string,null)
    The DNS zone that contains the domain's DNS records, if one exists.
    Example: "example.com"

  - `metadata` (object)

  - `metadata.command` (string)
    The method name called.
    Example: "has_local_authority"

  - `metadata.reason` (string)
    The reason the API function failed when the  field is . This field may display a success message when a function succeeds.
    Example: "OK"

  - `metadata.result` (integer)
    *  — Success.
*  — Failed. Check the  field for more details.
    Enum: 0, 1

  - `metadata.version` (integer)
    The version of the API function.
    Example: 1