# Get risk API usage and analytics

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

Endpoint: GET /api/v1/risk/stats
Version: 1.0.0
Security: ApiKeyAuth

## Response 200 fields (application/json):

  - `enabled` (boolean, required)
    Whether risk API is enabled for this customer
    Example: true

  - `quota` (object, required)

  - `quota.limit` (integer, required)
    Monthly API call limit
    Example: 1000

  - `quota.used` (integer, required)
    API calls used this month
    Example: 247

  - `quota.remaining` (integer, required)
    API calls remaining this month
    Example: 753

  - `quota.reset_at` (string, required)
    When quota resets (typically start of next month)
    Example: "2025-02-01T00:00:00Z"

  - `analytics` (object)
    Risk analytics across all previews this month

  - `analytics.total_previews` (integer)
    Total risk previews this month
    Example: 247

  - `analytics.average_risk_score` (number)
    Average risk score across all previews
    Example: 28.5

  - `analytics.would_block_count` (integer)
    Number of previews that would be blocked
    Example: 12

  - `analytics.would_block_percentage` (number)
    Percentage of previews that would be blocked
    Example: 4.9

  - `analytics.breakdown` (object)
    Average score breakdown by category

  - `analytics.breakdown.recipient` (number)
    Average recipient risk (0-40)
    Example: 12.3

  - `analytics.breakdown.content` (number)
    Average content risk (0-30)
    Example: 8.7

  - `analytics.breakdown.sender` (number)
    Average sender risk (0-20)
    Example: 5.2

  - `analytics.breakdown.behavior` (number)
    Average behavior risk (0-10)
    Example: 2.3

  - `top_factors` (array)
    Most common risk factors detected (top 5)
    Example: [{"reason_code":"disposable_medium_confidence","count":45,"percentage":18.2},{"reason_code":"sender_not_verified","count":38,"percentage":15.4},{"reason_code":"content_risk_medium","count":23,"percentage":9.3}]

  - `top_factors.reason_code` (string)
    Stable factor code
    Example: "disposable_medium_confidence"

  - `top_factors.count` (integer)
    Number of times detected
    Example: 45

  - `top_factors.percentage` (number)
    Percentage of total previews
    Example: 18.2

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message