- Add a sending domain POST
- Receive email at a domain POST
- Add a custom tracking domain POST
- Remove a sending domain DELETE
- Stop receiving email at a domain DELETE
- Remove a custom tracking domain DELETE
- Retrieve a DMARC report GET
- Retrieve a domain's DMARC status GET
- Retrieve a sending domain GET
- List a domain's DMARC reports GET
- List sending domains GET
- Check a domain's DNS records now POST
- Create an email template POST
- Delete an email template DELETE
- Retrieve a template's draft GET
- Retrieve a template version GET
- Retrieve an email template GET
- List a template's versions GET
- List email templates GET
- Publish a template's draft POST
- Restore a template version POST
- Update a template's draft PUT
- Update an email template PATCH
- Check an email address POST
- Check an IP address POST
- Check a rate limit POST
- Classify content POST
- Assess an event POST
- Report an assessment's outcome POST
- Create a rate limit bucket POST
- Add an allow or block list entry POST
- Create a rule POST
- Delete a rate limit bucket DELETE
- Remove a list entry DELETE
- Delete a rule DELETE
- Forget a user DELETE
- Retrieve an assessment GET
- Retrieve the calibration GET
- Retrieve a rate limit bucket GET
- Retrieve a list entry GET
- Retrieve a rule GET
- Retrieve the risk settings GET
- List assessments GET
- List rate limit buckets GET
- List allow and block list entries GET
- List rules GET
- Update a rate limit bucket PATCH
- Update a rule PATCH
- Update the risk settings PATCH
- Create a webhook endpoint POST
- Open a webhook listener POST
- Delete a webhook endpoint DELETE
- Close a webhook listener DELETE
- Retrieve a delivery GET
- Retrieve a webhook endpoint GET
- List an endpoint's deliveries GET
- List webhook endpoints GET
- Poll a webhook listener POST
- Recover failed deliveries POST
- Retry a delivery POST
- Roll a signing secret POST
- Update a webhook endpoint PATCH
List a domain's DMARC reports
The aggregate reports received about the domain, newest first, without their rows (retrieve one for those). Pass the last id as after to get the next page while has_more is true. Mailbox providers send DMARC aggregate reports to the domain's report_address once its _dmarc record names it (rua=mailto:…), usually once a day each.
bearerAuthAuthorizationBearer <token>A secret API key from the dashboard: coss_live_… for production environments, coss_test_… for sandbox environments.
id*stringThe domain's id.
limit?integer1-100, default 20.
1 <= value <= 100after?stringCursor: the id of the last report of the previous page.
length <= 64Coss-Version?"2026-10-10"The API version (a date) to use for this request. Defaults to your organization's version, pinned to the latest one when it first used the API and upgraded from the dashboard. The SDK always sends the version it was built for.
"2026-10-10"A page of DMARC reports.
application/json- response
- response
- …
object*"list""list"data*array<>has_more*booleanimport { Coss } from "coss";const coss = new Coss({ apiKey: process.env.COSS_API_KEY, baseUrl: "https://api.coss.com",});const { data, error } = await coss.domains.dmarc.reports.list("dom_01k7c8m4q2f3e9v6t5r1n0p8yz");{ "object": "list", "data": [ { "object": "dmarc_report", "id": "dmarcrep_01k7c8m4q2f3e9v6t5r1n0p8yz", "domain_id": "dom_01k7c8m4q2f3e9v6t5r1n0p8yz", "reporter": { "org_name": "google.com", "email": "noreply-dmarc-support@google.com" }, "report_id": "13845021974128475", "period_start": "2026-10-09T00:00:00.000Z", "period_end": "2026-10-09T23:59:59.000Z", "policy_published": { "domain": "acme.com", "p": "none", "sp": null, "np": null, "adkim": "r", "aspf": "r", "pct": 100, "testing": null }, "messages": 1204, "passing": 1200, "truncated": false, "received_at": "2026-10-10T03:12:44.000Z" } ], "has_more": false}