latestOpenAPI 3.0.2cPanel License2026-08-106251554.3 MB

3da41671c02c

Mail
Mail DNS Settings

Validate DMARC records

This function retrieves and checks the DMARC record for one or more domains.

get/validate_current_dmarcs

Query parameters

domainstring

The domain for which to check the DMARC record.

Note:

To check multiple domains, duplicate or increment the parameter name. For example, domain-1domain-2, and domain-3 parameters.

If you do not include this argument, the system will validate DMARC records for all domains on the server.

Response

HTTP Request was successful.

Example response

{
  "data": {
    "payload": [
      {
        "domain": "example.com",
        "error": "",
        "record": "v=DMARC1; p=none;",
        "state": "VALID",
        "subdomain": "_dmarc.example.com",
        "suggested": "v=DMARC1; p=none;"
      },
      {
        "domain": "example2.com",
        "error": "(XID 4krw35) DNS returned “SERVFAIL” (code 2) in response to the system’s query for “_dmarc.example2.com”’s “TXT” records.",
        "record": "",
        "state": "DNS_ERROR",
        "subdomain": "_dmarc.example2.com",
        "suggested": "v=DMARC1; p=none;"
      }
    ]
  },
  "metadata": {
    "command": "validate_current_dmarcs",
    "reason": "OK",
    "result": 1,
    "version": 1
  }
}