# Get outbound statistics overview

Overview of all outbound email statistics with optional date filtering.

Domain Filtering - Use the domain_id parameter to get statistics for a specific sending domain only.

Confidence-Based Scanner Detection - Use the filter parameter to exclude bot/scanner engagement and get accurate human-only metrics.

The system now uses a confidence score (0-100) to classify engagement:
- scanner (>= 80): Known email security systems and bots
- suspicious (50-79): Edge cases that may be automated
- human (< 50): Real user engagement

Gmail and Outlook Web clicks are correctly classified as "human" since these clients strip referrer headers for privacy but show other human signals (residential IP, real browser UA, normal timing).

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

## Query parameters:

  - `fromdate` (string)
    Start date for filtering (ISO 8601)
    Example: "2024-03-01T00:00:00Z"

  - `todate` (string)
    End date for filtering (ISO 8601)
    Example: "2024-03-31T23:59:59Z"

  - `filter` (string)
    Filter statistics by engagement type (NEW - Scanner Detection Feature):
- all (default): All opens/clicks including scanners
- human_only: Only real human engagement
- scanner_only: Only bot/scanner engagement
    Enum: "all", "human_only", "scanner_only"

  - `domain_id` (integer)
    Filter statistics by specific sending domain ID
    Example: 123

## Response 200 fields (application/json):

  - `sent` (integer)

  - `delivered` (integer)

  - `bounced` (integer)

  - `failed` (integer)

  - `opens` (integer)
    Total opens (filtered by filter parameter)

  - `unique_opens` (integer)
    Unique opens (filtered by filter parameter)

  - `clicks` (integer)
    Total clicks (filtered by filter parameter)

  - `human_opens` (integer)
    NEW - Confidence-Based Detection: Opens classified as human (confidence < 50).
Real user engagement excluding Gmail/Outlook image prefetch and security scanners.

  - `scanner_opens` (integer)
    NEW - Confidence-Based Detection: Opens classified as scanners (confidence >= 80).
Known email security scanners, bots, and automated systems.

  - `human_clicks` (integer)
    NEW - Confidence-Based Detection: Clicks classified as human (confidence < 50).
Real user clicks excluding security scanner pre-fetches.

  - `scanner_clicks` (integer)
    NEW - Confidence-Based Detection: Clicks classified as scanners (confidence >= 80).
Automated clicks from security systems.

  - `human_open_rate` (string)
    Percentage of emails opened by real humans (human_opens / sent * 100)
    Example: "15.50"

  - `human_click_rate` (string)
    Percentage of emails clicked by real humans (human_clicks / sent * 100)
    Example: "8.25"

  - `unique_clicks` (integer)
    Unique clicks (filtered by filter parameter)

  - `spam_complaints` (integer)

  - `tracked` (integer)
    Total tracked events (opens + clicks, filtered by filter parameter)

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message

## Response 500 fields (application/json):

  - `error` (string)
    Error code or message