Deliverability

DMARC aggregate reports for your domains

DMARC aggregate (RUA) reports receiving providers have sent about your verified domains, newest reporting window first.

The only signal on this surface that does not come from us. A report is a receiver saying what it saw arrive claiming to be your domain, from every source — which is how a sender finds out both that their own alignment is broken and that somebody else is sending as them.

pass_count counts DMARC ALIGNMENT from policy_evaluated, not raw authentication results: a message can pass SPF for a domain that is not the one in its From header, and that is precisely the case DMARC exists to catch.

Only reports about a domain registered in this project are stored, so a report about a domain you have not added will not appear here.

Requires the deliverability:read scope — Check why mail from one of your domains is not arriving.

get/api/v1/deliverability/dmarc

Request

  • Base URL: https://api.sendly.now
  • URL: https://api.sendly.now/api/v1/deliverability/dmarc
  • Auth: one of:
    • HTTP bearer
    • API key in cookie better-auth.session_token
    • OAuth 2 (authorization code, authorization URL https://app.sendly.now/api/auth/oauth2/authorize, token URL https://app.sendly.now/api/auth/oauth2/token, scopes: deliverability:read)

Query parameters

limitinteger
afterstring

Opaque cursor from a previous response's next_cursor.

daysinteger

How far back to read, by the report's window start. 1-180 days; defaults to 30.

domainstring

Restrict to reports about one of your domains.

Response

Cursor-paginated DMARC aggregate reports

has_moreboolean required
intake_configuredboolean required

Whether this deployment has a DMARC report intake mailbox configured. When false no report can ever arrive, so an empty data means the feature is off rather than that your domains are clean — the two are otherwise indistinguishable.

next_cursorstring nullable required

Pass as after to fetch the next page. null on the last page.

Changes

No recorded changes to this operation across all 1 revision of this API.