API Guide

DMARC Mail Breakdown

Retrieves a message count, by sending IP reverse DNS domain of the sending IP address, 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:

    "rdnsdomain": "mcsv.net",
    "count": 10399
    "rdnsdomain": "rsgsv.net",
    "count": 2479
    "rdnsdomain": "mcdlv.net",
    "count": 2048
    "rdnsdomain": "google.com",
    "count": 166
    "rdnsdomain": "sparkpostmail.com",
    "count": 149
    "rdnsdomain": "",
    "count": 116


Parameter Description Acceptable Values Required
domain Sender domain String Y
classification Classification of DMARC record to report
(compliant, non-compliant, unauthenticated)
String N
startdate Includes trap hits detected after the specified date. If unspecified, will default to 30 days prior. yyyy-mm-dd N
enddate Includes trap hits detected before the specified date. If unspecified, will default to the current date. 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 are no DMARC domains registered to the account.