---
title: "Generate report"
method: POST
path: "/analytics/reports"
tags: ["Reports"]
---

# Generate report

`POST /analytics/reports`

Returns aggregated marketing analytics grouped by message send date. Covers delivery, engagement, and revenue attribution metrics for campaigns and automations. Supports optional dimensions (timestamp, channel, activity), filters, and up to 4 queries per request.

**Scopes:**
`analytics.read`

## Headers

- `Omnisend-Version` string, required

## Request body

- ReportsReportRequest
  - `queries` ReportsReportQuery[]
    - `alias` string
    - `dateRange` ReportsDateRange
      - `from` string
      - `interval` string
      - `to` string
    - `dimensions` AnalyticsDimension[]
      - `granularity` string
      - `name` string
    - `filters` AnalyticsFilter[]
      - `name` string
      - `operator` string
      - `values` string[]
    - `metrics` AnalyticsMetric[]
      - `name` string

## Response `200`

OK

- ReportsReportResponse
  - `reports` ReportsReportResult[]
    - `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)