Supported Formats

JSON

GET https://api.dmarcreport.com/v2/accounts/:account_id/alerts
List all alerts for an account

Returns all alerts configured for domains in the specified account.

Alert Types: - metric: Triggered when a metric threshold is exceeded (e.g., emails_reported > 1000) - event: Triggered by specific events (e.g., new_subdomain_detected, dmarc_changed) - summary: Periodic summary reports

Event Types: - new_subdomain_detected: New subdomain sending email detected - new_forensic_report: New forensic (failure) report received - spf_dkim_alignments_and_delivery_rate_drops: Authentication alignment drops - dmarc_changed: DMARC record changed - spf_changed: SPF record changed - mx_changed: MX record changed - low_message_credits: Message credits running low

Metric Types: - emails_reported: Total emails in reports - compliant: DMARC-compliant emails - non_compliant: Non-compliant emails - threats: Suspicious/threat emails

Supported Formats

JSON

Errors

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

Params

Param name Description
active
optional

Filter by active status

Validations:

  • Must be one of: true, false, true, false.

alert_type
optional

Filter by alert type

Validations:

  • Must be one of: metric, event, summary.


GET https://api.dmarcreport.com/v2/accounts/:account_id/alerts/:id
Get alert details

Returns detailed information about a specific alert including all associated domains.

Supported Formats

JSON

Errors

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