---
title: "V2 Sync - Requesting Reports"
method: POST
path: "/v2/report/sync"
---

# V2 Sync - Requesting Reports

`POST /v2/report/sync`

## Request

- Base URL: `https://api.kevel.co`
- URL: `https://api.kevel.co/v2/report/sync`
- Auth: API key in header `X-Adzerk-ApiKey`

This endpoint generates reports synchonously when receiving POST requests.

## Request body

- object
  - `dimensions` string[], required: Object containing list of strings. One is required: `day`, `week`, `month`, or empty array (for total). You can also optionally break down by additional parameters listed [here](ref:reporting-api-1#groupby-and-parameter-fields---optional). Such as `"GroupBy": ["day","campaignId"]`.
  - `metrics` object, required: List of key/value pairs used for filtering. It's an unlimited number of criteria that will filter the report. More info [here](ref:reporting-api-1#groupby-and-parameter-fields---optional). Such as `"Parameters": [{"brandId": 12}]`
  - `timezone` string: Generates the report for a specific timezone. Default is GMT (UTC).
  - `intervals` string[], required: Used to set the date range
  - `limitSpec` string, required
  - `filterSpec` string, required
  - `sortSpec` string

## Other responses

- `100`: 100

---

[API](https://skmtc.dev/kevel/apis/adzerk-management-apis.md) - [All operations](https://skmtc.dev/kevel/apis/adzerk-management-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/kevel/apis/adzerk-management-apis/revisions/01ab38426629?raw)