Skip to content

Get delivery statistics

Request

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).

Security
ApiKeyAuth
Query
fromdatestring, (date-time)

Start date for filtering (ISO 8601)

Example:fromdate=2024-03-01T00:00:00Z
todatestring, (date-time)

End date for filtering (ISO 8601)

Example:todate=2024-03-31T23:59:59Z
tagstring

Filter by email tag

Example:tag=newsletter
domain_idinteger

Filter statistics by specific sending domain ID

Example:domain_id=123
precisionstring

Time granularity for statistics aggregation:

  • day (default): Daily aggregation
  • hour: Hourly aggregation
Default:"day"
Enum:"day""hour"
Example:precision=hour
curl -i -X GET \
  'https://api.mailerlogic.net/api/v1/stats/outbound/delivered?fromdate=2024-03-01T00%3A00%3A00Z&todate=2024-03-31T23%3A59%3A59Z&tag=newsletter&domain_id=123&precision=hour' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Delivery statistics retrieved successfully

Bodyapplication/json
daysArray of objects
domain_idinteger or null
Response
{
  "days": [
    { … }
  ],
  "domain_id": 0
}