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 MTA-STS failure details

AI-generated

Summary

Retrieve a list of MTA-STS failure details for a specified account and domain, optionally filtered and paginated according to user parameters.

Inputs

  • account_id (required) — The account id identifying the user account to query.
  • domain_id (required) — The domain id identifying the specific domain within the account.
  • returnAll — Whether to return all result pages or only a single page.
  • additionalFields — Optional query filters such as sending source IP, receiving source IP, result type, receiving MX hostname, pagination page number, and number of entries per page.
  • options — Additional options including custom JSON body overrides, custom HTTP headers, arbitrary query string filters, batching settings, debug flag for request details, pagination mode and parameters, and request timeout configuration.

Output shape

a list of MTA-STS failure detail records returned by the API

Supports pagination and filtering via query parameters. When 'returnAll' is false, only one page of results is returned based on pagination settings. Debug information can be included in the output if enabled.

Links

Discussion