Reputation GuardPOST/api/v1/risk-intelligence/analyze

Email Risk & Threat Intelligence API

Multi-signal threat scoring, spam trap probability, DNS hygiene (SPF/DKIM/DMARC), catch-all heuristics, and historical bounce probability.

Endpoint Specification

http
POST /api/v1/risk-intelligence/analyze
Host: api.bouncelayer.com
X-API-Key: bl_live_your_api_key_here
Content-Type: application/json

Request Payload

json
{
  "email": "cfo@target-domain.com",
  "include_dns": true,
  "include_smtp": true
}

Complete Response Payload

json
{
  "success": true,
  "email": "cfo@target-domain.com",
  "status": "risky",
  "credits_used": 1,
  "analysis_time_ms": 142.5,
  "risk": {
    "overall_score": 68,
    "risk_level": "Moderate",
    "deliverability_score": 55,
    "spam_trap_probability": "Low",
    "recommendation": "Accept with caution; domain accepts wildcard mail (Catch-All)."
  },
  "dns": {
    "has_mx": true,
    "mx_records": ["aspmx.l.google.com"],
    "has_spf": true,
    "spf_record": "v=spf1 include:_spf.google.com ~all",
    "has_dkim": true,
    "has_dmarc": true,
    "dmarc_policy": "quarantine"
  },
  "smtp": {
    "checked": true,
    "response_code": 250,
    "is_catch_all": true,
    "catch_all_confidence": 0.94,
    "connection_success": true,
    "supports_tls": true
  },
  "threats": {
    "is_disposable": false,
    "is_role_based": true,
    "is_free_provider": false,
    "is_corporate": true,
    "has_bounced_before": false,
    "historical_bounces": 0,
    "risk_factors": [
      "Catch-all wildcard domain accepts all incoming addresses",
      "Role-based administrative local-part (cfo@)"
    ]
  }
}

Risk Scoring Framework (0 - 100)

Risk ScoreRisk LevelRecommended Action
0 - 25Low RiskHigh confidence deliverability. Confirmed personal/corporate mailbox with strong DNS records. Safe for cold outreach.
26 - 60Moderate RiskCatch-all domains, free webmail addresses, or role-based inboxes. Acceptable for general campaigns if warmed up.
61 - 85High RiskThrowaway burner domains, domains missing MX/SPF, or past hard-bounce records. High likelihood of damaging sender reputation.
86 - 100Critical ThreatKnown honeypots, spam traps, malformed syntax, or dead servers. Do not mail under any circumstance.