# Statistics

Access detailed email delivery and engagement metrics.
Query sends, bounces, opens, clicks, and spam complaints with flexible date filters.


## Get usage statistics

 - [GET /api/v1/customer/usage](https://developers.mailerlogic.com/customer-api.openapi/statistics/paths/~1api~1v1~1customer~1usage/get.md): Retrieve current month's email usage and delivery statistics.

Optionally filter by domain_id to get statistics for a specific sending domain.

## Get outbound statistics overview

 - [GET /api/v1/stats/outbound](https://developers.mailerlogic.com/customer-api.openapi/statistics/paths/~1api~1v1~1stats~1outbound/get.md): 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).

## Get send statistics

 - [GET /api/v1/stats/outbound/sends](https://developers.mailerlogic.com/customer-api.openapi/statistics/paths/~1api~1v1~1stats~1outbound~1sends/get.md): Daily or hourly breakdown of emails sent with optional filtering.

Use domain_id to filter statistics for a specific sending domain.
Use precision to control time granularity (day or hour).

## Get delivery statistics

 - [GET /api/v1/stats/outbound/delivered](https://developers.mailerlogic.com/customer-api.openapi/statistics/paths/~1api~1v1~1stats~1outbound~1delivered/get.md): Daily or hourly breakdown of successfully delivered emails with optional filtering.

Shows emails that were accepted by the recipient's mail server.
Use domain_id to filter statistics for a specific sending domain.
Use precision to control time granularity (day or hour).

## Get bounce statistics

 - [GET /api/v1/stats/outbound/bounces](https://developers.mailerlogic.com/customer-api.openapi/statistics/paths/~1api~1v1~1stats~1outbound~1bounces/get.md): Daily or hourly breakdown of bounced emails with hard/soft bounce classification.

Use domain_id to filter statistics for a specific sending domain.
Use precision to control time granularity (day or hour).

## Get spam complaint statistics

 - [GET /api/v1/stats/outbound/spam](https://developers.mailerlogic.com/customer-api.openapi/statistics/paths/~1api~1v1~1stats~1outbound~1spam/get.md): Daily or hourly breakdown of spam complaints.

Use domain_id to filter statistics for a specific sending domain.
Use precision to control time granularity (day or hour).

## Get open statistics

 - [GET /api/v1/stats/outbound/opens](https://developers.mailerlogic.com/customer-api.openapi/statistics/paths/~1api~1v1~1stats~1outbound~1opens/get.md): Daily or hourly breakdown of email opens (total and unique).

Domain Filtering - Use domain_id to filter statistics for a specific sending domain.

Confidence-Based Scanner Detection - Use filter=human_only to exclude Gmail/Apple Mail privacy protection opens and security scanner bots for accurate engagement metrics.

Opens are classified using confidence scoring:
- human (= 80): Known security scanners, bots, automated systems

Use precision to control time granularity (day or hour).

## Get platform statistics

 - [GET /api/v1/stats/outbound/opens/platforms](https://developers.mailerlogic.com/customer-api.openapi/statistics/paths/~1api~1v1~1stats~1outbound~1opens~1platforms/get.md): Breakdown of email opens by email client platform (Gmail, Outlook, Apple Mail, etc.).

Use domain_id to filter statistics for a specific sending domain.

## Get click statistics

 - [GET /api/v1/stats/outbound/clicks](https://developers.mailerlogic.com/customer-api.openapi/statistics/paths/~1api~1v1~1stats~1outbound~1clicks/get.md): Daily or hourly breakdown of link clicks (total and unique).

Domain Filtering - Use domain_id to filter statistics for a specific sending domain.

Confidence-Based Scanner Detection - Use filter=human_only to exclude security scanner clicks for accurate click-through rates.

Clicks are classified with high accuracy:
- human (= 80): Proofpoint, Barracuda, Mimecast, curl, automated tools

Gmail and Outlook Web users clicking links are correctly identified as "human" even though these clients strip the Referer header.

Use precision to control time granularity (day or hour).