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.

Authorizations:
query Parameters
domain
required
string <domain>

The domain for which to validate the PTR records.

Examples:
domain=`domain`=example.com,`domain`=another.com,`domain`=yetanother.com `domain`=example.com,`domain-1`=another.com,`domain-2`=yetanother.com
domain=example.com

Responses

Response Schema: application/json
apiversion
integer

The version of the API.

func
string

The name of the method called.

module
string

The name of the module called.

object

Request samples

uapi --output=jsonpretty \
  --user=username \
  EmailAuth \
  validate_current_ptrs \
  domain='example.com'

Response samples

Content type
application/json
{
  • "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"
        }
      ],
    • "errors": null,
    • "messages": null,
    • "metadata": { },
    • "status": 1,
    • "warnings": null
    }
}