API Guide

DMARC Forensic Reports

Retrieves DMARC failure report metadata. 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:

    "id": 123456,
    "receiver": "hotmail.com",
    "reporteddomain": "250ok.com",
    "bouncedomain": null,
    "bouncebox": null,
    "fromdomain": "250ok.com",
    "frombox": "info",
    "dkimdomain": "250ok.com",
    "authfailure": "bodyhash",
    "source_ip": "",
    "subject": "Some subject line",
    "authres": "hotmail.com; spf=pass...",
    "dkim_result": "fail",
    "spf_result": "pass",
    "created": "2016-08-11 00:00:01"


Parameter Description Acceptable Values Required
domain Domain configured for DMARC (Required if no ID) String Y/N
id Failure report ID (Required if no domain) Int Y/N
startdate Date on which to start looking for data, in Y-m-d format; defaults to 30 days ago. String N
enddate Date on which to stop looking for data, in Y-m-d format; defaults to today. String 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 no DMARC reports for the registered domain provided.
There is no sample message available. 404 No message sample was found for the specified report ID.