mailersend · PeterOcansey · Mar 30, 2026
diff --git a/README.md b/README.md
@@ -104,6 +104,16 @@ MailerSend Java SDK
         - [Delete an SMS webhook](#delete-an-sms-webhook)
     - [SMS](#sms)
         - [Send an SMS with personalization](#send-an-sms-with-personalization)
+    - [DMARC Monitoring](#dmarc-monitoring)
+        - [Get a list of monitors](#get-a-list-of-monitors)
+        - [Create a monitor](#create-a-monitor)
+        - [Update a monitor](#update-a-monitor)
+        - [Delete a monitor](#delete-a-monitor)
+        - [Get aggregated reports](#get-aggregated-reports)
+        - [Get IP-specific reports](#get-ip-specific-reports)
+        - [Get report sources](#get-report-sources)
+        - [Mark IP as favorite](#mark-ip-as-favorite)
+        - [Remove IP from favorites](#remove-ip-from-favorites)
 
 - [Testing](#testing)
 - [Support and Feedback](#support-and-feedback)
@@ -2740,13 +2750,265 @@ public void sendSms() {
 }
 ```
 
+## DMARC Monitoring
+
+### Get a list of monitors
+
+```java
+import com.mailersend.sdk.MailerSend;
+import com.mailersend.sdk.dmarcmonitoring.DmarcMonitor;
+import com.mailersend.sdk.dmarcmonitoring.DmarcMonitorsList;
+import com.mailersend.sdk.exceptions.MailerSendException;
+
+public void listMonitors() {
+
+    MailerSend ms = new MailerSend();
+    ms.setToken("Your API token");
+
+    try {
+
+        DmarcMonitorsList list = ms.dmarcMonitoring().getMonitors();
+
+        for (DmarcMonitor monitor : list.monitors) {
+            System.out.println(monitor.id);
+            System.out.println(monitor.dmarcRecord);
+            System.out.println(monitor.spfStatus);
+        }
+
+    } catch (MailerSendException e) {
+        e.printStackTrace();
+    }
+}
+```
+
+### Create a monitor
+
+```java
+import com.mailersend.sdk.MailerSend;
+import com.mailersend.sdk.dmarcmonitoring.DmarcMonitor;
+import com.mailersend.sdk.exceptions.MailerSendException;
+
+public void createMonitor() {
+
+    MailerSend ms = new MailerSend();
+    ms.setToken("Your API token");
+
+    try {
+
+        DmarcMonitor monitor = ms.dmarcMonitoring().createMonitorBuilder()
+                .createMonitor("your-domain-id");
+
+        System.out.println(monitor.id);
+        System.out.println(monitor.wantedDmarcRecord);
+
+    } catch (MailerSendException e) {
+        e.printStackTrace();
+    }
+}
+```
+
+### Update a monitor
+
+```java
+import com.mailersend.sdk.MailerSend;
+import com.mailersend.sdk.dmarcmonitoring.DmarcMonitor;
+import com.mailersend.sdk.exceptions.MailerSendException;
+
+public void updateMonitor() {
+
+    MailerSend ms = new MailerSend();
+    ms.setToken("Your API token");
+
+    try {
+
+        DmarcMonitor monitor = ms.dmarcMonitoring().updateMonitorBuilder()
+                .wantedDmarcRecord("v=DMARC1; p=reject; rua=mailto:dmarc@yourdomain.com;")
+                .updateMonitor("your-monitor-id");
+
+        System.out.println(monitor.id);
+        System.out.println(monitor.wantedDmarcRecord);
+
+    } catch (MailerSendException e) {
+        e.printStackTrace();
+    }
+}
+```
+
+### Delete a monitor
+
+```java
+import com.mailersend.sdk.MailerSend;
+import com.mailersend.sdk.exceptions.MailerSendException;
+
+public void deleteMonitor() {
+
+    MailerSend ms = new MailerSend();
+    ms.setToken("Your API token");
+
+    try {
+
+        boolean deleted = ms.dmarcMonitoring().deleteMonitor("your-monitor-id");
+
+        System.out.println("Monitor deleted: " + deleted);
+
+    } catch (MailerSendException e) {
+        e.printStackTrace();
+    }
+}
+```
+
+### Get aggregated reports
+
+```java
+import com.mailersend.sdk.MailerSend;
+import com.mailersend.sdk.dmarcmonitoring.DmarcAggregatedReport;
+import com.mailersend.sdk.dmarcmonitoring.DmarcAggregatedReportList;
+import com.mailersend.sdk.exceptions.MailerSendException;
+
+public void getAggregatedReport() {
+
+    MailerSend ms = new MailerSend();
+    ms.setToken("Your API token");
+
+    try {
+
+        DmarcAggregatedReportList list = ms.dmarcMonitoring().getAggregatedReport("your-monitor-id");
+
+        for (DmarcAggregatedReport report : list.reports) {
+            System.out.println(report.ipAddress);
+            System.out.println(report.totalVolume);
+            System.out.println(report.passedDmarc);
+            System.out.println(report.isFavorite);
+        }
+
+    } catch (MailerSendException e) {
+        e.printStackTrace();
+    }
+}
+```
+
+### Get IP-specific reports
+
+```java
+import com.mailersend.sdk.MailerSend;
+import com.mailersend.sdk.dmarcmonitoring.DmarcIpReport;
+import com.mailersend.sdk.dmarcmonitoring.DmarcIpReportList;
+import com.mailersend.sdk.exceptions.MailerSendException;
+
+public void getIpReport() {
+
+    MailerSend ms = new MailerSend();
+    ms.setToken("Your API token");
+
+    try {
+
+        DmarcIpReportList list = ms.dmarcMonitoring().getIpReport("your-monitor-id", "1.2.3.4");
+
+        for (DmarcIpReport report : list.reports) {
+            System.out.println(report.ipAddress);
+            System.out.println(report.totalVolume);
+            System.out.println(report.appliedPolicy);
+            System.out.println(report.reportSource);
+        }
+
+    } catch (MailerSendException e) {
+        e.printStackTrace();
+    }
+}
+```
+
+### Get report sources
+
+```java
+import com.mailersend.sdk.MailerSend;
+import com.mailersend.sdk.dmarcmonitoring.DmarcReportSource;
+import com.mailersend.sdk.dmarcmonitoring.DmarcReportSourcesList;
+import com.mailersend.sdk.exceptions.MailerSendException;
+
+public void getReportSources() {
+
+    MailerSend ms = new MailerSend();
+    ms.setToken("Your API token");
+
+    try {
+
+        DmarcReportSourcesList list = ms.dmarcMonitoring().getReportSources("your-monitor-id");
+
+        for (DmarcReportSource source : list.sources) {
+            System.out.println(source.reportSource);
+            System.out.println(source.reports);
+        }
+
+    } catch (MailerSendException e) {
+        e.printStackTrace();
+    }
+}
+```
+
+### Mark IP as favorite
+
+```java
+import com.mailersend.sdk.MailerSend;
+import com.mailersend.sdk.exceptions.MailerSendException;
+
+public void markIpAsFavorite() {
+
+    MailerSend ms = new MailerSend();
+    ms.setToken("Your API token");
+
+    try {
+
+        boolean marked = ms.dmarcMonitoring().markIpAsFavorite("your-monitor-id", "1.2.3.4");
+
+        System.out.println("IP marked as favorite: " + marked);
+
+    } catch (MailerSendException e) {
+        e.printStackTrace();
+    }
+}
+```
+
+### Remove IP from favorites
+
+```java
+import com.mailersend.sdk.MailerSend;
+import com.mailersend.sdk.exceptions.MailerSendException;
+
+public void removeIpFromFavorites() {
+
+    MailerSend ms = new MailerSend();
+    ms.setToken("Your API token");
+
+    try {
+
+        boolean removed = ms.dmarcMonitoring().removeIpFromFavorites("your-monitor-id", "1.2.3.4");
+
+        System.out.println("IP removed from favorites: " + removed);
+
+    } catch (MailerSendException e) {
+        e.printStackTrace();
+    }
+}
+```
+
 # Testing
 
-Change the properties in the `TestHelper` class of the `com.mailersend.sdk.tests` package to correspond to your account details, then simply run
+To run the tests you need **Java 11+** and **Maven 3.6+** installed.
+
+The test suite uses VCR (video cassette recorder) fixtures — pre-recorded HTTP responses stored in `src/test/resources/fixtures/` — so no live API token is required for the existing tests.
+
+To run all tests:
 ```
 mvn test
 ```
 
+To run only the DMARC Monitoring tests:
+```
+mvn test -Dtest=DmarcMonitoringTest
+```
+
+If you want to record new fixtures against the real API, set your token in `TestHelper.validToken` and delete the relevant fixture JSON file before running the tests. The VCR recorder will make the real API call and save the response for future runs.
+
 <a name="support-and-feedback"></a>
 # Support and Feedback
 

diff --git a/src/main/java/com/mailersend/sdk/MailerSend.java b/src/main/java/com/mailersend/sdk/MailerSend.java
@@ -20,6 +20,7 @@
 import com.mailersend.sdk.tokens.Tokens;
 import com.mailersend.sdk.webhooks.Webhooks;
 import com.mailsend.sdk.emailverification.EmailVerification;
+import com.mailersend.sdk.dmarcmonitoring.DmarcMonitoring;
 
 /**
  * Main SDK Class
@@ -44,6 +45,7 @@ public class MailerSend {
     private ScheduledMessages scheduledMessages = null;
     private EmailVerification emailVerification = null;
     private Sms sms = null;
+    private DmarcMonitoring dmarcMonitoring = null;
 
     /**
      * <p>Constructor for MailerSend.</p>
@@ -63,6 +65,7 @@ public MailerSend() {
         scheduledMessages = new ScheduledMessages(this);
         emailVerification = new EmailVerification(this);
         sms = new Sms(this);
+        dmarcMonitoring = new DmarcMonitoring(this);
     }
 
 
@@ -203,6 +206,15 @@ public Sms sms() {
     	return sms;
     }
 
+    /**
+     * Get the DMARC monitoring access object
+     *
+     * @return the DmarcMonitoring object
+     */
+    public DmarcMonitoring dmarcMonitoring() {
+        return dmarcMonitoring;
+    }
+
     /**
      * Sets the MailerSend token
      *

diff --git a/src/main/java/com/mailersend/sdk/dmarcmonitoring/DmarcAggregatedReport.java b/src/main/java/com/mailersend/sdk/dmarcmonitoring/DmarcAggregatedReport.java
@@ -0,0 +1,41 @@
+/*************************************************
+ * MailerSend Java SDK
+ * https://github.com/mailersend/mailersend-java
+ *
+ * @author MailerSend <support@mailersend.com>
+ * https://mailersend.com
+ **************************************************/
+package com.mailersend.sdk.dmarcmonitoring;
+
+import com.google.gson.annotations.SerializedName;
+import com.mailersend.sdk.MailerSendResponse;
+
+/**
+ * Represents a single row in an aggregated DMARC report.
+ */
+public class DmarcAggregatedReport extends MailerSendResponse {
+
+    @SerializedName("ip_address")
+    public String ipAddress;
+
+    @SerializedName("total_volume")
+    public int totalVolume;
+
+    @SerializedName("passed_dmarc")
+    public float passedDmarc;
+
+    @SerializedName("passed_spf")
+    public float passedSpf;
+
+    @SerializedName("passed_dkim")
+    public float passedDkim;
+
+    @SerializedName("domain")
+    public String domain;
+
+    @SerializedName("country")
+    public String country;
+
+    @SerializedName("is_favorite")
+    public boolean isFavorite;
+}
diff --git a/src/main/java/com/mailersend/sdk/dmarcmonitoring/DmarcAggregatedReportList.java b/src/main/java/com/mailersend/sdk/dmarcmonitoring/DmarcAggregatedReportList.java
@@ -0,0 +1,20 @@
+/*************************************************
+ * MailerSend Java SDK
+ * https://github.com/mailersend/mailersend-java
+ *
+ * @author MailerSend <support@mailersend.com>
+ * https://mailersend.com
+ **************************************************/
+package com.mailersend.sdk.dmarcmonitoring;
+
+import com.google.gson.annotations.SerializedName;
+import com.mailersend.sdk.util.PaginatedResponse;
+
+/**
+ * Represents a paginated list of aggregated DMARC reports.
+ */
+public class DmarcAggregatedReportList extends PaginatedResponse {
+
+    @SerializedName("data")
+    public DmarcAggregatedReport[] reports;
+}