DMARC reports

List DMARC reports

GET/api/v1/dmarc/reports

Who can use this: Site adminsAs Markdown

One row per report. org_name is the receiver that sent it, date_begin to date_end the period it covers, and the policy_ fields the policy it found published. messages is how many messages it covers, and records how many lines it has.

Parameters

Name	Where	What it is
days	query	How many days back to look. 30 if you leave it out.
domain	query	Only reports about this domain.
limit	query	At most this many reports. 100 if you leave it out, 1000 at most.

curl -s 'https://api.mailmasker.org/api/v1/dmarc/reports' \
  -H "Authorization: Bearer $TOKEN"

use Mojo::Base -strict;
use Mojo::UserAgent;

my $ua  = Mojo::UserAgent->new;
my $res = $ua->get('https://api.mailmasker.org/api/v1/dmarc/reports',
    { Authorization => "Bearer $ENV{TOKEN}" })->result;
die $res->code, ' ', ($res->json('/error') // $res->message), "\n" unless $res->is_success;
print $res->body, "\n";

There's no homelab-cli command for this yet.

Response 200 OK

{
  "days": 30,
  "reports": [
    {
      "id": 412,
      "org_name": "example.net",
      "report_id": "18342296310421557",
      "policy_domain": "example.com",
      "policy_p": "quarantine",
      "policy_pct": 100,
      "policy_adkim": "r",
      "policy_aspf": "r",
      "date_begin": "2026-11-02 18:00:00-06",
      "date_end": "2026-11-03 17:59:59-06",
      "ingested_at": "2026-11-03 21:00:03.998120-06",
      "messages": 214,
      "records": 2
    }
  ]
}