Postmaster account records
List and Search the Postmaster accounts. Plus get all the details of an individual Postmaster Accout domain.

Supported Formats

JSON
>>>

GET api.dmarcreport.com/v2/postmaster_account_records.json
Cummulative data of all domains of a Postmaster Account

Supported Formats

JSON

Errors

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

Examples

{
    "data": {
        "abc.com": {
            "total_spam_ratio": 0.0,
            "domain_reputation": "HIGH",
            "total_spf_success": 43.0,
            "total_dkim_success": 43.0,
            "total_dmarc_success": 35.703,
            "total_inbound_encryption": 43.0,
            "total_records": 43,
            "delivery_errors": 0.0,
            "ip_reputations": {
                "counts": {},
                "percentages": {}
            },
            "average_spam_ratio": 0.0,
            "average_spf_success": 100.0,
            "average_dkim_success": 100.0,
            "average_dmarc_success": 83.0,
            "average_inbound_encryption": 100.0
        },
        "xyz.com": {
            "error_message": "The caller does not have permission"
        },
        "example.org": {
            "total_spam_ratio": 0.20600000000000002,
            "domain_reputation": "HIGH",
            "total_spf_success": 79.0,
            "total_dkim_success": 79.0,
            "total_dmarc_success": 1.338,
            "total_inbound_encryption": 79.0,
            "total_records": 79,
            "delivery_errors": 0.0,
            "ip_reputations": {
                "counts": {
                    "BAD": 363,
                    "LOW": 448,
                    "MEDIUM": 1747,
                    "HIGH": 2387
                },
                "percentages": {
                    "BAD": 7.3,
                    "LOW": 9.1,
                    "MEDIUM": 35.3,
                    "HIGH": 48.3
                }
            },
            "average_spam_ratio": 0.3,
            "average_spf_success": 100.0,
            "average_dkim_success": 100.0,
            "average_dmarc_success": 1.7,
            "average_inbound_encryption": 100.0
        }
    }
}

Params

Param name Description
email
required

Email address of Postmaster Account

Validations:

  • Must be a String
>>>

GET api.dmarcreport.com/v2/postmaster_account_records/:id.json
Details of a Postmaster Account domain.

Supported Formats

JSON

Errors

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

Examples

{
    "spam_rate_data": {
        "2025-02-20": 0.0,
        "2025-02-24": 0.0,
        "2025-05-05": 0.0,
        "2025-05-06": 0.0,
        "2025-05-15": 0.0
    },
    "ip_reputation_data": {
        "2025-02-20": {
            "BAD": {
                "percentage": 0.0,
                "ips": []
            },
            "LOW": {
                "percentage": 0.0,
                "ips": []
            },
            "MEDIUM": {
                "percentage": 0.0,
                "ips": []
            },
            "HIGH": {
                "percentage": 0.0,
                "ips": []
            }
        },
        "2025-02-21": {
            "BAD": {
                "percentage": 0.0,
                "ips": []
            },
            "LOW": {
                "percentage": 0.0,
                "ips": []
            },
            "MEDIUM": {
                "percentage": 0.0,
                "ips": []
            },
            "HIGH": {
                "percentage": 0.0,
                "ips": []
            }
        },
        "2025-05-15": {
            "BAD": {
                "percentage": 0.0,
                "ips": []
            },
            "LOW": {
                "percentage": 0.0,
                "ips": []
            },
            "MEDIUM": {
                "percentage": 0.0,
                "ips": []
            },
            "HIGH": {
                "percentage": 0.0,
                "ips": []
            }
        }
    },
    "domain_reputation_data": {
        "2025-02-20": "High",
        "2025-03-21": "High",
        "2025-03-26": "High",
        "2025-03-27": "High",
        "2025-03-31": "High",
        "2025-04-01": "High",
        "2025-05-12": "High",
        "2025-05-14": "High",
        "2025-05-15": "High"
    },
    "feedback_loop_data": {
        "2025-05-09": [
            {
                "id": 41,
                "domain": "xyz.com",
                "date": "2025-05-09",
                "spam_rate": 0.0,
                "spammy_feedback_loops": 0
            }
        ],
        "2025-05-12": [
            {
                "id": 42,
                "domain": "xyz.com",
                "date": "2025-05-12",
                "spam_rate": 0.0,
                "spammy_feedback_loops": 0
            }
        ],
        "2025-05-14": [
            {
                "id": 43,
                "domain": "xyz.com",
                "date": "2025-05-14",
                "spam_rate": 0.0,
                "spammy_feedback_loops": 0
            }
        ],
        "2025-05-15": [
            {
                "id": 44,
                "domain": "xyz.com",
                "date": "2025-05-15",
                "spam_rate": 0.0,
                "spammy_feedback_loops": 0
            }
        ]
    },
    "authentication_data": {
        "2025-05-12": {
            "spf": 100.0,
            "dkim": 100.0,
            "dmarc": 100.0
        },
        "2025-05-14": {
            "spf": 100.0,
            "dkim": 100.0,
            "dmarc": 98.1
        },
        "2025-05-15": {
            "spf": 100.0,
            "dkim": 100.0,
            "dmarc": 99.1
        }
    },
    "encryption_data": {
        "2025-05-08": {
            "inbound_tls": 100.0,
            "outbound_tls": "N/A"
        },
        "2025-05-09": {
            "inbound_tls": 100.0,
            "outbound_tls": "N/A"
        },
        "2025-05-12": {
            "inbound_tls": 100.0,
            "outbound_tls": "N/A"
        },
        "2025-05-14": {
            "inbound_tls": 100.0,
            "outbound_tls": "N/A"
        },
        "2025-05-15": {
            "inbound_tls": 100.0,
            "outbound_tls": "N/A"
        }
    },
    "delivery_errors_data": {
        "2025-02-20": [],
        "2025-03-26": [
            {
                "error_type": "PERMANENT_ERROR",
                "reason": "Content Spammy",
                "percentage": 0.7
            }
        ],
        "2025-03-27": [],
        "2025-05-14": [],
        "2025-05-15": []
    }
}

Params

Param name Description
email
required

Email address of Postmaster Account

Validations:

  • Must be a String
item
required

Domain for which data is needed

Validations:

  • Must be a String
>>>

GET api.dmarcreport.com/v2/postmaster_account_records/connected.json
List of connected Postmaster Accounts.

Supported Formats

JSON

Errors

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

Examples

{
    "connected_accounts": [
        {
            "id": 3,
            "email": "abc@gmail.com",
            "created_at": "2025-05-16T09:26:58.159Z"
        },
        {
            "id": 4,
            "email": "xyz@example.com",
            "created_at": "2025-05-20T10:47:52.964Z"
        }
    ]
}