---
title: "/2026-01/statistics/report"
method: POST
path: "/2026-01/statistics/report"
tags: ["Analytics"]
---

# /2026-01/statistics/report

`POST /2026-01/statistics/report`

This Statistics endpoint provides ad set related data. It is an upgrade of our previous Statistics endpoint, and includes new metrics and customization capabilities.
<br/><br/>
This endpoint supports data retrieval for up to two years in the past.

## Request body

- StatisticsReportQueryMessage — This is the message defining the query for Adset report
  - `adSetIds` string[], nullable — Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be fetched.
  - `adSetNames` string[], nullable — Optional list of ad set names to filter on. If empty, all ad sets will be fetched.
  - `adSetStatus` string[], nullable — Optional list of ad set statuses to filter on. If empty, all ad sets will be fetched.
  - `advertiserIds` string, required — List of advertiser IDs to report on, provided as a single comma-separated string (e.g., "123,456,789"). The advertisers must already exist. If empty, all advertisers will be used.
  - `currency` string, required — The currency used for the report. ISO 4217 code (three-letter capitals).
  - `dimensions` string[], required — List of dimensions for the report. At least one dimension should be provided. <br/><br/> When an ID dimension is requested (e.g., AdsetId), the corresponding name dimension (e.g., Adset) is automatically included, and vice versa. This applies to the following pairs: AdsetId/Adset, AdId/Ad, AdvertiserId/Advertiser, CampaignId/Campaign, CategoryId/Category, CouponId/Coupon, MarketingObjectiveId/MarketingObjective, ChannelId/Channel.
  - `endDate` string, date-time, required — End date of the report. Date component of ISO 8601 format, any time or timezone component is ignored.
  - `format` 'csv' | 'excel' | 'xml' | 'json' — Optional file format of the generated report.
  - `metrics` string[], required — List of metrics for the report. Provide at least one metric to return performance data; otherwise, the response will include only dimension-related information.
  - `startDate` string, date-time, required — Start date of the report. Date component of ISO 8601 format, any time or timezone component is ignored. Must be ≤ endDate.
  - `timezone` string, nullable — Optional timezone used for the report. Timezone Database format (Tz).

## Response `200`

Success

- string, binary

---

[API](https://skmtc.net/criteo/apis/criteo-api.md) · [All operations](https://skmtc.net/criteo/apis/criteo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/criteo/criteo-api/revisions/c1721589426a/schema)