---
title: "Generate report"
method: POST
path: "/analytics/statistics"
tags: ["Statistics"]
---

# Generate report

`POST /analytics/statistics`

Returns aggregated marketing analytics grouped by event date (when opens, clicks, orders actually occurred). Covers delivery, engagement, revenue attribution, and audience growth metrics. Requires a timestamp dimension. Supports a rich set of dimensions (client, click, subscription, deliverability) and up to 4 queries per request.

**Scopes:**
`analytics.read`

## Headers

- `Omnisend-Version` string, required

## Request body

- StatisticsReportRequest
  - `queries` StatisticsReportQuery[]
    - `alias` string
    - `dateRange` StatisticsDateRange
      - `from` string — RFC3339/ISO8601 format
      - `to` string — RFC3339/ISO8601 format
    - `dimensions` AnalyticsDimension[]
      - `granularity` string
      - `name` string
    - `filters` AnalyticsFilter[]
      - `name` string
      - `operator` string
      - `values` string[]
    - `metrics` AnalyticsMetric[]
      - `name` string

## Response `200`

OK

- StatisticsReportResponse
  - `statistics` StatisticsReportResult[]
    - `alias` string
    - `dimensions` AnalyticsDimensionHeader[]
      - `granularity` string
      - `name` string
    - `metrics` AnalyticsMetricHeader[]
      - `name` string
    - `rows` AnalyticsReportResultRow[]

## Other responses

- `400` — Validation error
- `403` — Forbidden
- `415` — Unsupported media type
- `429` — Too many requests
- `500` — Internal server error
- `503` — Service temporarily unavailable
- `524` — Timeout

---

[API](https://skmtc.dev/omnisend/apis/events-api.md) · [All operations](https://skmtc.dev/omnisend/apis/events-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnisend/events-api/revisions/50214fbc283f/schema)