API Guide

DMARC Mail Sources

Retrieves DMARC report mail volume for a domain, broken down by the sending organization, for a specified time period. Data is returned in the following formats: XML, JSON, CSV and Serialized.

Required headers: X-API-KEY
Optional headers: ACCEPT (json, xml, csv, serialized)
Method: GET

Endpoint URL:


Sample Output:

    "source": "MailChimp||MailChimp",
    "complaint": 227701,
    "non-compliant": 294,
    "unauthenticated": 0,
    "total": 227995,
    "pct": 94.8
    "source": "Amazon Technologies Inc.||Amazon Technologies Inc.",
    "complaint": 3294,
    "non-compliant": 1,
    "unauthenticated": 0,
    "total": 3295,
    "pct": 1.4
    "source": "Google Inc.||Google Inc.",
    "complaint": 2838,
    "non-compliant": 77,
    "unauthenticated": 3,
    "total": 2918,
    "pct": 1.2


Parameter Description Acceptable Values Required
domain Domain monitored (i.e. 250ok.com). String Y
startdate Starting date (defaults to 30 days ago). yyyy-mm-dd N
enddate Ending date (defaults to today). yyyy-mm-dd N

Error Responses

Description Code Cause
Domain is required. 400 Please specify a domain for the query.
Bad or missing API key. 401 The X-API-KEY header was missing or contained an unrecognized/invalid key.
No results found. 404 There were results for the specified domain and date range.