# Validate DMARC records

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

Endpoint: GET /validate_current_dmarcs
Version: 11.134.0.5
Security: BasicAuth

## Query parameters:

  - `domain` (string)
    The domain for which to check the DMARC record.



To check multiple domains, duplicate or increment the parameter name.
For example, , , and  parameters.

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

## Response 200 fields (application/json):

  - `data` (object)

  - `data.payload` (array)
    An array of objects containing information about the domain's DMARC records.
    Example: [{"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;"}]

  - `data.payload.domain` (string)
    The target domain of the DMARC policy.
    Example: "example.com"

  - `data.payload.error` (string)
    A message that details either why the DNS lookup failed, or if there is a SPF/DKIM failure.
    Example: "(XID 4krw35) DNS returned SERVFAIL (code 2)\nin response to the system's query for _dmarc.example.com\nTXT records."

  - `data.payload.record` (string)
    The domain's DMARC TXT record.
    Example: "v=DMARC1; p=none;"

  - `data.payload.state` (string)
    The domain's DMARC record status.
Possible values:

*  - A DMARC policy is set for the domain, along with valid SPF and DKIM records for the domain and IP address.
*  - A DMARC record is set, but it did not pass a syntax check.
*  - A DMARC record exists; however, both the DKIM and SPF records for this domain did not pass validation.
*  - A DMARC record exists; however, the DKIM record for this domain did not pass validation.
*  - A DMARC record exists; however, the SPF record for this domain did not pass validation.
*  - No DMARC policy record exists for the domain at the DMARC subdomain location.
*  - A DNS error prevented validation of the DMARC record.
    Enum: "VALID", "MALFORMED", "DKIM_SPF_ERROR", "DKIM_ERROR", "SPF_ERROR", "MISSING", "DNS_ERROR"

  - `data.payload.subdomain` (string)
    The domain that the function used to check
the DMARC record. This will be the value of
the  parameter with a  prefix.
    Example: "_dmarc.example.com"

  - `data.payload.suggested` (string)
    The recommended DMARC policy.
    Example: "v=DMARC1; p=none;"

  - `metadata` (object)

  - `metadata.command` (string)
    The method name called.
    Example: "validate_current_dmarcs"

  - `metadata.reason` (string)
    The reason the API function failed when the  field is . This field may display a success message when a function succeeds.
    Example: "OK"

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

  - `metadata.version` (integer)
    The version of the API function.
    Example: 1