sendsend.email
Sign inStart building

List who sends as your domain

GET/v1/dmarc/domains/{id}/sources

Every server that sent mail using the domain in the period, busiest first: its address and reverse-DNS name, the service it belongs to when we recognise it (Amazon SES, Google Workspace, SendGrid and so on), how many messages passed and failed, and what to do about it.

Required scope: domains:manage

Parameters

NameInDescription
idrequiredpathThe DMARC domain id.
daysoptionalqueryLook back this many days, 1 to 90. Default 30.
limitoptionalqueryAt most this many senders, 1 to 200. Default 50.

Example

curl -X GET 'https://api.sendsend.email/v1/dmarc/domains/ID/sources' \
  -H "Authorization: Bearer $SENDSEND_API_KEY"

Response 200

{
  "object": "list",
  "domain_id": "dmd_3f9a…",
  "days": 30,
  "data": [
    {
      "object": "dmarc_source",
      "ip": "54.240.8.12",
      "host": "a8-12.smtp-out.amazonses.com",
      "service": "Amazon SES",
      "messages": 9200,
      "pass": 9200,
      "fail": 0,
      "pass_rate": 1,
      "verdict": "passing",
      "advice": "Amazon SES passes DMARC."
    }
  ]
}

Errors

StatusCodeWhen
404not_foundNo such resource in this project.
401unauthorizedThe API key is missing, invalid or revoked.
403forbiddenThe key does not have the scope this endpoint needs.

Every error has the same shape. See Errors.