Email tests
Email authentication test results for a domain

Supported Formats

JSON
>>>

GET https://api.dmarcreport.com/v2/email_tests/address
Get test email address for a domain

Returns the email address that should be used for sending test emails. Send a test message from any source (WordPress, SendGrid, CRM, etc.) to this address to validate SPF, DKIM, and DMARC authentication.

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"
}

Params

Param name Description
domain
required

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

Validations:

  • Must be a String
>>>

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
>>>

GET https://api.dmarcreport.com/v2/email_tests/:id
Get email test details

Returns detailed information about a specific email test, including full authentication results, raw headers, and alignment status.

Supported Formats

JSON

Errors

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

Examples

{
  "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"
  },
  "raw_headers": {
    "auth_results": "dkim=pass header.i=@sendgrid.net; spf=pass smtp.mailfrom=bounce.sendgrid.net",
    "received": "from smtp.sendgrid.net (192.0.2.10)"
  },
  "read": false,
  "created_at": "2026-05-19T12:00:00Z",
  "updated_at": "2026-05-19T12:00:00Z"
}

Params

Param name Description
domain
required

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

Validations:

  • Must be a String
id
required

Email test ID

Validations:

  • Must be a number.