Validate DMARC records

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

SecurityBasicAuth

Request

query Parameters

domain

string

The domain for which to check the DMARC record.

Note:

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

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

Examples:

Check the DMARC record for multiple domains. domain=domain-1=example.com&domain-2=example.com&domain-3=example3.com

Check the DMARC record for multiple domains. domain=domain=example.com&domain=example2.com&domain=example3.com

Check the DMARC records for a single domain. domain=domain=example.com

Responses

200

HTTP Request was successful.

Response Schema: application/json

	object
	object

get/validate_current_dmarcs

Request samples

whmapi1 --output=jsonpretty \
  validate_current_dmarcs \
  domain='example.com'

Response samples

application/json

{"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
}
}