v1

latestOpenAPI 3.0.2cPanel License2026-08-06657427.1 MB
EmailAuth
Email DNS Settings

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.

get/EmailAuth/validate_current_ptrs

Query parameters

domainstring domain required

The domain for which to validate the PTR records.

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": "validate_current_ptrs",
  "module": "EmailAuth",
  "result": {
    "data": [
      {
        "arpa_domain": "1.0.0.10.in-addr.arpa",
        "domain": "example.com",
        "error": "1.1.1.1.1 is not a valid IP address.",
        "helo": "example.com",
        "ip_address": "10.0.0.1",
        "ip_version": 4,
        "nameservers": [
          "ns1.example.com"
        ],
        "ptr_records": [
          {
            "domain": "example.com",
            "forward_records": [
              "10.0.0.1"
            ],
            "state": "VALID"
          }
        ],
        "state": "VALID"
      }
    ],
    "status": 1
  }
}