---
title: "Get grouped app events statistics"
method: GET
path: "/api/v1/events/grouped-statistics"
tags: ["Events (Clicks)"]
---

# Get grouped app events statistics

`GET /api/v1/events/grouped-statistics`

Get grouped statistics of app events with various filters.

**Available Filters:**
- **tracker** - Filter by one or more tracker IDs
- **offer** - Filter by one or more offer IDs
- **domain** - Filter by domain name
- **appNamespace** - Filter by one or more app namespaces (package names)
- **country** - Filter by country code
- **startDate** - Start date to filter events (ISO 8601 format)
- **endDate** - End date to filter events (ISO 8601 format)

## Query parameters

- `tracker` string[], nullable — Filter by one or more tracker IDs
- `offer` string[], nullable — Filter by one or more offer IDs
- `domain` string, nullable — Filter by domain name
- `appNamespace` string[], nullable — Filter by one or more app namespaces (package names)
- `country` string, nullable — Filter by country code
- `startDate` string, date-time, nullable — Optional start date to filter events (ISO 8601 format)
- `endDate` string, date-time, nullable — Optional end date to filter events (ISO 8601 format)
- `page` integer
- `size` integer

## Response `200`

Successful Response

- PageAppEventsGroupedStatisticsDTO
  - `items` AppEventsGroupedStatisticsDTO[], required
    - `eventDay` string, date, nullable
    - `trackerId` string, uuid, required
    - `trackerName` string, nullable, required
    - `offerId` string, uuid, nullable
    - `offerName` string, nullable
    - `domain` string, required
    - `appNamespace` string, nullable
    - `country` string, nullable, required
    - `preLandingId` string, uuid, nullable
    - `preLandingName` string, nullable
    - `postLandingId` string, uuid, nullable
    - `postLandingName` string, nullable
    - `eventCount` integer, required
    - `clickCount` integer
    - `installGrayCount` integer
    - `uniqueClickCount` integer
    - `leadGrayCount` integer
    - `saleGrayCount` integer
    - `repeatedSaleGrayCount` integer
    - `uniqueClickToInstallPercentage` number
    - `installToLeadPercentage` number
    - `leadToSalePercentage` number
    - `leadToRepeatedSalePercentage` number
    - `totalCpi` number
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required
  - `pages` integer, required

## Other responses

- `400` — The request is invalid.
- `404` — The requested resource was not found.
- `422` — Validation Error

---

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