Skip to main content

Compare Baseline

enterprise
POST/v1/reports/compare-baseline

Compares a domain's current posture against a declarative policy baseline and returns per-rule pass/fail. Baselines cover DMARC policy minimums, SPF strictness, required DKIM presence, DNSSEC signing, MTA-STS enforcement, minimum email and security scores, and severity-count thresholds.

What It Does

Accepts a domain plus a baseline object (POST body) describing required minimums. Runs the relevant checks (SPF, DMARC, DKIM, MTA-STS, DNSSEC). For each baseline rule, evaluates pass/fail and records expected vs. actual. Returns the rule-level verdict list, overall compliance (pass or fail), and a summary line suitable for CI/CD gating.

Why It's Useful

Lets security teams encode their standards as a reusable baseline, then apply it uniformly to every domain. A baseline file becomes the definition of compliant.

Use Cases

Platform Team

Compliance Gating in CI/CD

Run baseline checks against every managed domain nightly; fail the pipeline on any regression.

Continuous assurance that every domain meets organizational email-auth standards.

IT Integration Lead

M&A Integration Gate

Evaluate acquired-company domains against the acquirer's baseline; scope uplift work.

Quantified integration debt before close.

Parameters

NameTypeRequiredDescription
domainstringRequiredThe domain to evaluate. Baseline rules are passed in the JSON POST body.Example: example.com

Response Fields

FieldTypeDescription
domainstringThe evaluated domain
compliantbooleanWhether all baseline rules pass
rulesarrayPer-rule verdict: rule, expected, actual, status (pass/fail)
summarystringOne-line pass/fail summary

Code Examples

cURL
curl "https://api.edgedns.dev/v1/reports/compare-baseline" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "domain=example.com"
JavaScript
const response = await fetch(
  'https://api.edgedns.dev/v1/reports/compare-baseline?domain=example.com',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data);
Python
import requests

response = requests.get(
    'https://api.edgedns.dev/v1/reports/compare-baseline',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
    'domain': 'example.com'
    }
)

data = response.json()
print(data)

Read the full Compare Baseline guide

Why it matters, real-world use cases, parameters, response fields, and how to call it from Claude, ChatGPT, or Gemini via MCP.

Read the guide →

Related Endpoints

External References

Learn more about the standards and protocols behind this endpoint.

Try This Endpoint

Test the Compare Baseline endpoint live in the playground.