# Validate domains' PTR records

This function validates the pointer records (PTR) for IPv4 and
IPv6 addresses that the account's domains send mail from. It retrieves the
PTR records for each IP address and determines which of the domain's IP addresses
send mail. It then validates the PTR records for each IP address and validates
the A or AAAA records pointing to each domain. This function also ensures
that at least one of that domain's A or AAAA records points back to the IP
address.

Endpoint: GET /EmailAuth/validate_current_ptrs
Version: 11.134.0.5
Security: BasicAuth

## Query parameters:

  - `domain` (string, required)
    The domain for which to validate the PTR records.

## Response 200 fields (application/json):

  - `apiversion` (integer)
    The version of the API.
    Example: 3

  - `func` (string)
    The name of the method called.
    Example: "validate_current_ptrs"

  - `module` (string)
    The name of the module called.
    Example: "EmailAuth"

  - `result` (object)

  - `result.data` (array)
    An array that contains information about the account's PTR records.

  - `result.data.arpa_domain` (string)
    The IP address used to perform a reverse DNS (rDNS) lookup.
For more information about rDNS, read our
[How to Configure Reverse DNS for BIND in WHM](https://go.cpanel.net/HowtoConfigureReverseDNSforBINDinWHM)
documentation.
A valid reversed IP address appended with one of the following:
* in-addr.arpa - An IPv4 address.
* ip6.arpa - An IPv6 address.

For information about .arpa domains, read Wikipedia's
[Reverse DNS lookup](https://en.wikipedia.org/wiki/Reverse_DNS_lookup)
article.



The function does not return this value for a domain with an invalid IP address.
    Example: "1.0.0.10.in-addr.arpa"

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

  - `result.data.error` (string)
    A mmessage that details the reason why the domain's IP address validation failed.



The function only returns this value when the  returned is
the  value.
    Example: "1.1.1.1.1 is not a valid IP address."

  - `result.data.helo` (string)
    The hostname that the domain uses to identify
itself to remote SMTP servers. A valid hostname.
    Example: "example.com"

  - `result.data.ip_address` (string)
    The IP address.



The function does  return this value for a domain with an invalid IP address.
    Example: "10.0.0.1"

  - `result.data.ip_version` (integer)
    The IP version number.
* 4
* 6



The function does  return this value for a domain with an invalid IP address.
    Enum: 4, 6

  - `result.data.nameservers` (array)
    The authoritative nameservers for the domain's PTR record.
    Example: ["ns1.example.com"]

  - `result.data.ptr_records` (array)
    The domain's PTR records.



The function does  return this for a domain with an invalid IP address.

  - `result.data.ptr_records.domain` (string)
    The fully-qualified domain name (FQDN)
that a PTR record points to.
    Example: "example.com"

  - `result.data.ptr_records.forward_records` (array)
    A list of IP addresses that the domain
resolves to for A (IPv4) and AAAA (IPv6) records.
    Example: ["10.0.0.1"]

  - `result.data.ptr_records.state` (string)
    The state of the domain's PTR record.
*  - The PTR record is valid.
*  - The PTR points to a domain without an A or AAAA record.
*  - The PTR record points to a domain without an A or AAAA record that points back to the IP address.
    Enum: "VALID", "MISSING_FWD", "FWD_MISMATCH"

  - `result.data.state` (string)
    Whether the PTR records are valid for the domain.
*  - The domain's IP address is invalid. The function returns the reason in the error return.
*  - The IP address exists within a range of private IP addresses.
*  - The PTR record is valid.
*  - No PTR records exist for the IP address.
*  - One or more PTR records point to a domain that does not point back to the correct IP address.



* DNS does not define PTR records for private IP addresses.
* The function only returns a VALID response if all of an IP address's PTR records are valid.
    Enum: "ERROR", "IP_IS_PRIVATE", "VALID", "MISSING_PTR", "PTR_MISMATCH"

  - `result.errors` (array,null)
    List of errors if the API failed.

  - `result.messages` (array,null)
    List of messages generated by the API.

  - `result.metadata` (object)

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

  - `result.warnings` (array,null)
    List of warnings generated by the API. Warnings describe non-critical failures or other problematic conditions noted while running a API.