DMARC Report icon

DMARC Report

API documentation for DMARC Report v2. Provides endpoints for managing accounts, domains, aggregate reports, forensic (failure) reports, MTA-STS reports, postmaster account records, and account members.

Actions35

Domains → Verify hosted MTA-STS setup status

AI-generated

Summary

Verify the hosted MTA-STS setup status for a specified domain belonging to a given account.

Inputs

  • Account Id (required) — The account ID to which the domain belongs.
  • Id (required) — The domain ID to verify.
  • Record — Select which MTA-STS related record to verify: Policy, MTA-STS, TLS-RPT, or All (default).
  • Custom Body — Optionally provide custom JSON to include in the request body, overriding other body parameters.
  • Custom Headers — Add additional HTTP headers to include in the API request.
  • Query Filters — Add query-string filters to modify the API request.
  • Batching — Configure batching to group input items into batches for sequential requests.
  • Debug — Enable debug mode to include the full request details in the output for troubleshooting.
  • Pagination — Configure the pagination settings when expecting multiple pages in responses.
  • Timeout (ms) — Set the maximum time to wait for the server response before aborting.

Output shape

a single JSON object representing the verification result for the hosted MTA-STS setup of the domain.

The response reflects the state of the MTA-STS policy or related DNS records as specified by the selected 'Record' parameter. Debug output, if enabled, includes full request details. Pagination and batching settings allow handling multiple requests or large data sets, but typically this verify operation returns one result per domain.

Links

Discussion