Returns the top email sources (senders) for a domain, aggregated by PTR domain.

Each source includes: - source: The PTR domain of the sending servers (e.g., “google.com”, “sendgrid.net”) - total: Total email volume from this source - compliant: DMARC-compliant emails (passed authentication) - non_compliant: Non-compliant emails (failed authentication) - compliance_rate: Percentage of compliant emails (0-100)

Sources are sorted by total volume (highest first).

Use this to identify: - Your legitimate email services and their authentication status - High-volume senders that may need SPF/DKIM configuration - Unknown sources that could be spoofing attempts

Supported Formats

JSON

Errors

Code Description
401 Unauthorized
404 Not Found
500 Server crashed for some reason

Examples

{
  "domain": "example.com",
  "period": {
    "start_date": "2026-05-01",
    "end_date": "2026-05-31"
  },
  "total_sources": 5,
  "sources": [
    {
      "source": "google.com",
      "total": 450,
      "compliant": 448,
      "non_compliant": 2,
      "compliance_rate": 99.6
    },
    {
      "source": "sendgrid.net",
      "total": 120,
      "compliant": 85,
      "non_compliant": 35,
      "compliance_rate": 70.8
    },
    {
      "source": "mailchimp.com",
      "total": 75,
      "compliant": 75,
      "non_compliant": 0,
      "compliance_rate": 100.0
    },
    {
      "source": "Unknown",
      "total": 45,
      "compliant": 0,
      "non_compliant": 45,
      "compliance_rate": 0.0
    },
    {
      "source": "amazonses.com",
      "total": 30,
      "compliant": 28,
      "non_compliant": 2,
      "compliance_rate": 93.3
    }
  ]
}

Params

Param name Description
q
optional

Params for date filtering

Validations:

  • Must be a Hash

q[start_date]
optional

Start date, Format: YYYY-MM-DD

Validations:

  • Must be a String

q[end_date]
optional

End date, Format: YYYY-MM-DD

Validations:

  • Must be a String

filter
optional

Preset filter: last_7_days, last_10_days, last_15_days, last_30_days (default: last_30_days)

Validations:

  • Must be a String

limit
optional

Maximum number of sources to return (default: 10, max: 50)

Validations:

  • Must be a number.