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

MTASTSReports → List, search, and paginate MTA-STS reports

AI-generated

Summary

List, search, and paginate through MTA-STS reports for a specified account and domain.

Inputs

  • account_id (required) — The account ID under which to list the MTA-STS reports.
  • domain_id (required) — The domain ID for which to list the MTA-STS reports.
  • returnAll — Whether to return all results across pages or only a single page.
  • additionalFields — Optional filters and pagination parameters, including start and end datetimes, organization name, report ID, policy type, policy host, page number, and number of entries per page.
  • options — Additional request configuration such as custom request body JSON, HTTP headers, query filters, batching settings, debug flag, pagination mode and settings, and request timeout.

Output shape

a list of MTA-STS report items potentially across multiple pages depending on pagination and returnAll settings.

The output data array may be nested and requires specifying the response data path if using cursor or URL-based pagination. Supports offset-, cursor-, and URL-based pagination modes. Debug information is included in the output if enabled. Pagination respects limits such as max pages and request intervals.

Links

Discussion