# Risk Assessment

Pre-send risk assessment API for Professional and Enterprise plans.
Preview risk scores before sending emails to reduce bounce rates, improve deliverability, and maintain sender reputation.
Get detailed risk analysis with actionable recommendations and enforcement policy insights.


## Preview risk score before sending (advisory)

 - [POST /api/v1/risk/preview](https://developers.mailerlogic.com/customer-api.openapi/risk-assessment/paths/~1api~1v1~1risk~1preview/post.md): Pre-send guidance to help you decide whether to send an email.

Returns a risk assessment with a would_block boolean that indicates whether the platform will block this email if you attempt to send it.

Important Contract:
- This is advisory - you make the decision
- If would_block = true, calling /api/v1/send will also block for the same reason
- If would_block = false but risk is medium/high, you can still choose to send
- Platform may throttle/warn on high risk sends depending on your plan

Risk Score Ranges:
- 0-29: Safe (send)
- 30-49: Low risk (warn)
- 50-69: Medium risk (soft block - customer can override)
- 70-100: High/Critical risk (hard block)

Hard Blocks (would_block = true):
- Known spamtraps (spamtrap_detected)
- Previous spam complaints (previous_complaint)
- High-confidence disposable domains > 0.85 (disposable_high_confidence)
- Sender verification failure if enabled (sender_not_verified)
- Risk score >= 70 (risk_score_critical)

Stable Reason Codes (for programmatic handling):
- disposable_high_confidence - Disposable domain with 90%+ confidence
- disposable_medium_confidence - Disposable domain with 50-89% confidence
- sender_not_verified - DKIM/SPF not verified
- spamtrap_detected - Known spamtrap address
- previous_complaint - Recipient marked previous email as spam
- previous_hard_bounce - Hard bounce on previous send
- content_risk_high - High spam content score
- velocity_first_send_bulk - First send attempt is bulk email
- volume_spike - Unusual sending volume increase

Quota:
- Available on Professional and Enterprise plans
- Check /api/v1/risk/stats for usage and remaining quota

## Get risk API usage and analytics

 - [GET /api/v1/risk/stats](https://developers.mailerlogic.com/customer-api.openapi/risk-assessment/paths/~1api~1v1~1risk~1stats/get.md): Retrieve usage statistics, trends, and risk analytics for the Risk Score API.

Information provided:
- Current quota (used/limit/remaining/reset_at)
- Top risk factors detected in your previews
- Average risk score across all previews
- Breakdown of risk categories (recipient/content/sender/behavior)
- Block rate statistics

Use this to:
- Monitor API quota consumption
- Understand common risk patterns in your sends
- Identify areas for improvement (e.g., "30% of risk from unverified senders")
- Plan list cleaning or content optimization strategies