Data & Examples
Real API Response Examples
Use these examples to build your integration. We show you the exact data you'll get for security findings, risk levels, and fix plans.
Standard Audit Result
This is the core result from the Veldica API. It turns complex email settings into clear, structured data your code can act on.
Response Object: AuditResponse
200 OK
{
"audit_id": "aud_01jk5v...",
"domain": "example.com",
"score": 92,
"grade": "A",
"risk": {
"risk_level": "low",
"enforcement_status": "partial",
"assessment_confidence": "high",
"executive_summary": "The domain is well-protected, though minor configuration sprawl is noted.",
"top_3_actions": ["Consolidate SPF includes", "Monitor aggregate reports"]
},
"mail_flow_profile": "corporate_mail_active",
"findings": [
{
"id": "dmarc.policy_quarantine",
"check": "dmarc",
"title": "DMARC Policy Set to Quarantine",
"status": "pass",
"severity": "low",
"evidence": "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com",
"fix": null
},
{
"id": "spf.include_sprawl",
"check": "spf",
"title": "SPF Include Sprawl Detected",
"status": "warn",
"severity": "medium",
"evidence": "The record contains 8 recursive lookups, approaching the limit of 10.",
"fix": "Consolidate includes or use an SPF flattening service."
}
]
}Before and After Comparison
The compare tool finds the real changes between two checks, making it easy to prove that your security fixes worked.
Response Object: AuditComparisonResponse
200 OK
{
"compared_domain": "example.com",
"score_delta": 15,
"previous_score": 77,
"current_score": 92,
"grade_changed": true,
"added_findings": [
{
"id": "dmarc.policy_reject",
"check": "dmarc",
"previous_status": null,
"current_status": "pass"
}
],
"resolved_findings": [
{
"id": "dmarc.policy_none",
"check": "dmarc",
"previous_status": "warn",
"current_status": null
}
],
"summary": "The domain has successfully moved to a stronger security policy."
}Easy-to-Use Fix Plans
The fix-plan tool gives you exact, ready-to-use instructions for updating your DNS records.
Response Object: RemediationPlan
200 OK
{
"domain": "example.com",
"exact_remediations": [
{
"issue_id": "dmarc.missing_rua",
"priority": "p1",
"why_it_matters": "Security reports are currently being lost.",
"dns_name": "_dmarc.example.com",
"record_type": "TXT",
"operation": "replace",
"proposed_value_template": "v=DMARC1; p=reject; rua=mailto:reports@example.com"
}
],
"priority_summary": ["P1: dmarc.missing_rua (high priority, low risk)"]
}Ready to build?
These examples are ready for your code. Start building your domain security automation today.