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

# Generate report

`POST /analytics/reports`

## Request

- Base URL: `https://api.omnisend.com/api`
- URL: `https://api.omnisend.com/api/analytics/reports`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://app.omnisend.com/oauth2/token` scopes: `analytics.read`
  - API key in header `Authorization`

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`

**Rate Limiting:**
This endpoint is rate limited to 10 requests per minute and 55 requests per 24 hours.
Rate limits apply per brand. See [Rate limits](https://api-docs.omnisend.com/reference/reports#rate-limits).

## 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/analytics-api.md) - [All operations](https://skmtc.dev/omnisend/apis/analytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omnisend/apis/analytics-api/revisions/f7e0f6bc0aab?raw)