DMARC Reports

DMARC reporting provides valuable insights into your infrastructure, helping you identify potential issues like senders, misconfigured email servers, or phishing attempts.

Retrieves the DMARC DNS records to be used for configuration

SecuritybasicAuth

Request

path Parameters

domain

required

string

Fully qualified domain name

Example: example.com

Responses

200

OK | The records for DMARC DNS Setup

Response Schema: application/json

Schema not provided

get/v1/dmarc/records/{domain}

Request samples

Response samples

application/json

{"entry": "v=DMARC1; p=none; pct=100; fo=1; ri=3600; rua=mailto:abcdef12@inbox.ondmarc.com; ruf=mailto:abcdef12@inbox.ondmarc.com;",
"current": "v=DMARC1; p=none; pct=100; fo=1; ri=3600; rua=mailto:abcdef12@inbox.ondmarc.com; ruf=mailto:abcdef12@inbox.ondmarc.com;",
"configured": true
}

Checks if DMARC has been setup for user

SecuritybasicAuth

Responses

200

OK | Setup metadata for DMARC

Response Schema: application/json

Schema not provided

get/v1/dmarc/setup

Request samples

Response samples

application/json

{"InstanceID": "d8798aa87905456b123c98745987f21379f9102389cc0981",
"LastAccessed": "2025-01-22T21:16:25.55Z",
"CreatedAt": "2025-01-22T21:16:25.55Z",
"UpdatedAt": "2025-01-22T21:16:25.55Z"
}

Gets referral link to redsift

SecuritybasicAuth

Request

Request Body schema: application/json
required

Request for referral Link

required

string

Responses

200

OK | Referral Link to Redsift

Response Schema: application/json

Schema not provided

post/v1/dmarc/referral

Request samples

application/json

{"email": "string"
}

Response samples

application/json

{"referral_uri": "https://redsift.com/partners/mailgun?token=token"
}

Retrieves the list of domains that have DMARC monitoring.

SecuritybasicAuth

Request

query Parameters

from	integer UNIX epoch (UTC seconds) representing the start of the time range. Example: from=1736790000
to	integer UNIX epoch (UTC seconds) representing the end of the time range. If supplied, `from` must also be set. Example: to=1736790285

Responses

200

OK | Object representing a list of DMARC monitored domains

Response Schema: application/json

Schema not provided

get/v1/dmarc/domains

Request samples

Response samples

application/json

{"domains": [{"label": "Mailgun.com",
"uri": "/domains/mailgun.com",
"email_count": "79,",
"reputation": 0.5,
"compliance_rate": 0.58,
"dmarc_failures": "43,",
"spf_rate": 0.9983,
"dkim_rate": 0.9977
},
{"label": "Mailjet.com",
"uri": "/domains/mailjet.com",
"email_count": "69,",
"reputation": 1,
"compliance_rate": 0.65,
"dmarc_failures": "30,",
"spf_rate": 0.98,
"dkim_rate": 0.9243
}
],
"pfqr_chart": [{"pass": 111,
"fail": 11,
"quarantined": 123,
"rejected": 12334,
"date": 1736527388
},
{"pass": 199,
"fail": 2,
"quarantined": 9,
"rejected": 0,
"date": 1736526388
}
]
}

Retrieve DMARC reporting data for a domain.

SecuritybasicAuth

Request

path Parameters

domain

required

string

Fully qualified domain name

Example: example.com

query Parameters

from	integer UNIX epoch (UTC seconds) representing the start of the time range. Example: from=1736790000
to	integer UNIX epoch (UTC seconds) representing the end of the time range. If supplied, `from` must also be set. Example: to=1736790285

Responses

200

OK | Object representing a DMARC monitored domain

Response Schema: application/json

Schema not provided

404

Not found | Domain not managed by this account

get/v1/dmarc/domains/{domain}

Request samples

Response samples

application/json

{"email_count": "79,",
"compliance_rate": 0.58,
"dmarc_policy": "p=none 100%",
"pfqr_chart": [{"pass": 111,
"fail": 11,
"quarantined": 123,
"rejected": 12334,
"date": 1736527388
},
{"pass": 199,
"fail": 2,
"quarantined": 9,
"rejected": 0,
"date": 1736526388
}
],
"sources": [{"label": "mail.we.static.321",
"uri": "/domains/mailgun.com/s/mail.we.static.321",
"email_count": 10,
"reputation": 0.5,
"ip_count": 1,
"dmarc_failures": 0,
"spf_rate": 0.98,
"dkim_rate": 0.9243,
"ruf": "todo"
},
{"label": "mx.example.com",
"uri": "/domains/mailgun.com/s/mx.example.com",
"email_count": 10,
"reputation": 0,
"ip_count": 3,
"dmarc_failures": 10,
"spf_rate": 0.9534,
"dkim_rate": 0.8743,
"ruf": "todo"
}
]
}

Retrieve DMARC reporting data from a specific source.

SecuritybasicAuth

Request

path Parameters

domain required	string Fully qualified domain name Example: example.com
source required	string User friendly source id name Example: mailgun

query Parameters

from	integer UNIX epoch (UTC seconds) representing the start of the time range. Example: from=1736790000
to	integer UNIX epoch (UTC seconds) representing the end of the time range. If supplied, `from` must also be set. Example: to=1736790285

Responses

200

OK | Object representing DMARC info for a source

Response Schema: application/json

Schema not provided

404

Not found | Source related to domain not found

get/v1/dmarc/domains/{domain}/s/{source}

Request samples

Response samples

application/json

{"email_count": "79,",
"compliance_rate": 0.58,
"ip_count": 2,
"pfqr_chart": [{"pass": 111,
"fail": 11,
"quarantined": 123,
"rejected": 12334,
"date": 1736527388
},
{"pass": 199,
"fail": 2,
"quarantined": 9,
"rejected": 0,
"date": 1736526388
}
],
"hostnames": [{"label": "123.4.54.123",
"uri": "/domains/mailgun.com/s/mx.example.com/h/123.4.54.123",
"email_count": 10,
"reputation": 0.5,
"ip_count": 1,
"dmarc_failures": 0,
"spf_rate": 0.98,
"dkim_rate": 0.9243
},
{"label": "mx-1234.mx.example.com",
"uri": "/domains/mailgun.com/s/mx.example.com/h/mx-1234.mx.example.com",
"email_count": 10,
"reputation": 0.5,
"ip_count": 3,
"dmarc_failures": 10,
"spf_rate": 0.9534,
"dkim_rate": 0.8743
}
],
"auth_events": [{"protocol": "SPF",
"disposition": "none",
"reason": "Short reason",
"detail": "Detailed reason",
"result": "temperror",
"email_count": 3,
"dmarc_failures": 0,
"date": 1736527388
}
]
}

Retrieve DMARC reporting data for a hostname.

SecuritybasicAuth

Request

path Parameters

domain required	string Fully qualified domain name Example: example.com
source required	string User friendly source id name Example: mailgun
host required	string Host name Example: mx.mailgun.com

query Parameters

from	integer UNIX epoch (UTC seconds) representing the start of the time range. Example: from=1736790000
to	integer UNIX epoch (UTC seconds) representing the end of the time range. If supplied, `from` must also be set. Example: to=1736790285

Responses

200

OK | Object representing DMARC info for a hostname

Response Schema: application/json

Schema not provided

404

Not found | Host related to source not found

get/v1/dmarc/domains/{domain}/s/{source}/h/{host}

Request samples

Response samples

application/json

{"email_count": "79,",
"ip_count": 2,
"spf_fail_events": 1,
"dkim_fail_events": 1,
"auth_fail_events": 1,
"pfqr_chart": [{"pass": 111,
"fail": 11,
"quarantined": 123,
"rejected": 12334,
"date": 1736527388
},
{"pass": 199,
"fail": 2,
"quarantined": 9,
"rejected": 0,
"date": 1736526388
}
],
"ip_addresses": [{"label": "123.4.54.123",
"uri": "/domains/mailgun.com/s/mx.example.com/h/123.4.54.123/ip/123.4.54.123",
"email_count": 10,
"reputation": 0.5,
"ip_count": 1,
"dmarc_failures": 0,
"spf_rate": 0.98,
"dkim_rate": 0.9243,
"ruf": "todo",
"country": "USA"
},
{"label": "8.8.8.8",
"uri": "/domains/mailgun.com/s/mx.example.com/h/123.4.54.123/ip/8.8.8.8",
"email_count": 10,
"reputation": 0.5,
"ip_count": 3,
"dmarc_failures": 10,
"spf_rate": 0.9534,
"dkim_rate": 0.8743,
"ruf": "todo",
"country": "CN"
}
],
"auth_events": [{"protocol": "SPF",
"disposition": "none",
"reason": "Short reason",
"detail": "Detailed reason",
"result": "temperror",
"email_count": 3,
"dmarc_failures": 0,
"date": 1736527388
}
]
}

Retrieve DMARC reporting data for an IP Address.

SecuritybasicAuth

Request

path Parameters

domain required	string Fully qualified domain name Example: example.com
source required	string User friendly source id name Example: mailgun
host required	string Host name Example: mx.mailgun.com
ip required	string a valid IPv4 or IPv6 address Example: 8.8.8.8

query Parameters

from	integer UNIX epoch (UTC seconds) representing the start of the time range. Example: from=1736790000
to	integer UNIX epoch (UTC seconds) representing the end of the time range. If supplied, `from` must also be set. Example: to=1736790285

Responses

200

OK | Object representing DMARC info for an IP Address

Response Schema: application/json

Schema not provided

404

Not found | IP related to host not found

get/v1/dmarc/domains/{domain}/s/{source}/h/{host}/ip/{ip}

Request samples

Response samples

application/json

{"email_count": "79,",
"ip_count": 2,
"spf_fail_events": 1,
"dkim_fail_events": 1,
"auth_fail_events": 1,
"ruf": "todo",
"pfqr_chart": [{"pass": 111,
"fail": 11,
"quarantined": 123,
"rejected": 12334,
"date": 1736527388
},
{"pass": 199,
"fail": 2,
"quarantined": 9,
"rejected": 0,
"date": 1736526388
}
],
"auth_events": [{"protocol": "SPF",
"disposition": "none",
"reason": "Short reason",
"detail": "Detailed reason",
"result": "temperror",
"email_count": 3,
"dmarc_failures": 0,
"date": 1736527388
}
]
}

Cookie Policy GDPR Email Compliance Acceptable Use Policy Terms of Service Privacy Policy

DMARC Reports

Retrieves the DMARC DNS records to be used for configuration

path Parameters

Response Schema: application/json

Checks if DMARC has been setup for user

Response Schema: application/json

Gets referral link to redsift

Request Body schema: application/jsonrequired

Response Schema: application/json

Retrieves the list of domains that have DMARC monitoring.

query Parameters

Response Schema: application/json

Retrieve DMARC reporting data for a domain.

path Parameters

query Parameters

Response Schema: application/json

Retrieve DMARC reporting data from a specific source.

path Parameters

query Parameters

Response Schema: application/json

Retrieve DMARC reporting data for a hostname.

path Parameters

query Parameters

Response Schema: application/json

Retrieve DMARC reporting data for an IP Address.

path Parameters

query Parameters

Response Schema: application/json

Request Body schema: application/json
required