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/jsonRequest 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 Score | Risk Level | Recommended Action |
|---|---|---|
| 0 - 25 | Low Risk | High confidence deliverability. Confirmed personal/corporate mailbox with strong DNS records. Safe for cold outreach. |
| 26 - 60 | Moderate Risk | Catch-all domains, free webmail addresses, or role-based inboxes. Acceptable for general campaigns if warmed up. |
| 61 - 85 | High Risk | Throwaway burner domains, domains missing MX/SPF, or past hard-bounce records. High likelihood of damaging sender reputation. |
| 86 - 100 | Critical Threat | Known honeypots, spam traps, malformed syntax, or dead servers. Do not mail under any circumstance. |