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