GET https://api.dmarcreport.com/v2/email_tests
List email tests for a domain

Returns a paginated list of email test results for the domain. Each test shows the authentication status (SPF, DKIM, DMARC) for emails sent to the domain’s test address.

Supported Formats

JSON

Errors

Code Description
401 Unauthorized
403 Forbidden
404 Not Found
422 Unprocessable Entity - domain parameter missing

Examples

{
  "domain": "caboplatinum.com",
  "test_email_address": "abc123.t@dmarcinput.com",
  "email_tests": [
    {
      "id": 123,
      "header_from": "sender@caboplatinum.com",
      "sending_domain": "caboplatinum.com",
      "sending_source": "smtp.sendgrid.net",
      "sending_source_public_suffix": "sendgrid.net",
      "sender_ip": "192.0.2.10",
      "spf": {
        "domain": "sendgrid.net",
        "auth": "pass",
        "alignment": "not_aligned"
      },
      "dkim": {
        "domains": ["sendgrid.net"],
        "auth": "pass",
        "alignment": "not_aligned"
      },
      "dmarc": {
        "result": "fail",
        "policy": "none"
      },
      "helo": {
        "domain": "smtp.sendgrid.net",
        "spf_auth": "pass"
      },
      "read": false,
      "created_at": "2026-05-19T12:00:00Z",
      "updated_at": "2026-05-19T12:00:00Z"
    }
  ],
  "meta": {
    "total_records": 1,
    "current_page": 1,
    "per_page": 25,
    "total_pages": 1
  }
}

Params

Param name Description
domain
required

Domain address (e.g., “example.com”)

Validations:

  • Must be a String
page
optional

Page number

Validations:

  • Must be a String
per
optional

Records per page (default: 25, max: 100)

Validations:

  • Must be a String
unread
optional

Filter by read status (true/false)

Validations:

  • Must be a String
source
optional

Filter by sending source hostname

Validations:

  • Must be a String