GET https://api.dmarcreport.com/v2/accounts/:account_id/domains/:domain_id/agg_reports/alignment_failures
Get SPF/DKIM alignment failures ranked by volume

Returns email sources that are failing DMARC authentication, ranked by failure volume.

Each failure entry includes: - source: The PTR domain of the failing sender - failure_count: Number of non-compliant emails - percentage_of_total_failures: This source’s share of all failures

Use this to identify: - Legitimate services that need SPF/DKIM configuration - Potential spoofing sources to investigate - Priority order for remediation (highest volume first)

Note: Sources with email_service identification can be cross-referenced with get_email_sources to find setup instructions for SPF/DKIM configuration.

Supported Formats

JSON

Errors

Code	Description
401	Unauthorized
404	Not Found
500	Server crashed for some reason

Examples

{
  "domain": "example.com",
  "period": {
    "start_date": "2026-05-01",
    "end_date": "2026-05-31"
  },
  "total_failure_sources": 4,
  "total_failure_count": 84,
  "failures": [
    {
      "source": "Unknown",
      "failure_count": 45,
      "percentage_of_total_failures": 53.6
    },
    {
      "source": "sendgrid.net",
      "failure_count": 35,
      "percentage_of_total_failures": 41.7
    },
    {
      "source": "google.com",
      "failure_count": 2,
      "percentage_of_total_failures": 2.4
    },
    {
      "source": "amazonses.com",
      "failure_count": 2,
      "percentage_of_total_failures": 2.4
    }
  ]
}

Params

Param name	Description
q optional	Params for date filtering Validations: Must be a Hash
q[start_date] optional	Start date, Format: YYYY-MM-DD Validations: Must be a String
q[end_date] optional	End date, Format: YYYY-MM-DD Validations: Must be a String
filter optional	Preset filter: last_7_days, last_10_days, last_15_days, last_30_days (default: last_30_days) Validations: Must be a String
limit optional	Maximum number of failures to return (default: 20, max: 100) Validations: Must be a number.