Транзакционная почта

Статистика по ключу отправки

Агрегированная статистика транзакционных писем по ключу отправки за период (по предрассчитанным дневным данным). Без dateFrom/dateTo возвращает последние 30 дней.

get/v1/public/external-mails/keys/{keyId}/stats

Request

Base URL: https://api.rusender.ru/api
URL: https://api.rusender.ru/api/v1/public/external-mails/keys/{keyId}/stats
Auth: HTTP bearer

Path parameters

keyIdinteger required

ID ключа отправки.

Query parameters

dateFromstring

Example:2026-01-01

Начало периода (YYYY-MM-DD, включительно). По умолчанию — 30 дней до dateTo.

dateTostring

Example:2026-01-31

Конец периода (YYYY-MM-DD, включительно). По умолчанию — сегодня.

Response

Агрегированная статистика по ключу за период.

okboolean required

Флаг успешного выполнения.

Example response

{
  "ok": true,
  "data": {
    "dateFrom": "2026-01-01",
    "dateTo": "2026-01-31",
    "totals": {
      "all": 1000,
      "delivered": 950,
      "opened": 400,
      "clicked": 120,
      "error": 20,
      "softBounced": 15,
      "hardBounced": 15,
      "unsubscribed": 5,
      "complaint": 2
    },
    "rates": {
      "openRate": 0.421,
      "clickRate": 0.126,
      "errorRate": 0.05,
      "unsubscribeAndComplaintRate": 0.007
    }
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-03-05T12:00:00.000Z",
    "pagination": {
      "page": 1,
      "limit": 20,
      "totalItems": 150,
      "totalPages": 8
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.