---
id: event-report
title: eventReport
---

Aggregate event data. Requires reports:read and source scopes; monetary metrics require finance:read and currency.

```graphql
eventReport(
  currency: String
  filter: EventFilter
  metric: EventReportInput!
): ReportResult
```

### Arguments

#### [`eventReport.currency`](#currency) · [`String`](/docs/developers/api-reference/management/v1/types/scalars/string) **scalar** {#currency}

Required for monetary metrics. Only source amounts in this currency contribute.

#### [`eventReport.filter`](#filter) · [`EventFilter`](/docs/developers/api-reference/management/v1/types/inputs/event-filter) **input** {#filter}

Filter the complete source dataset before aggregation.

#### [`eventReport.metric`](#metric) · [`EventReportInput!`](/docs/developers/api-reference/management/v1/types/inputs/event-report-input) **non-null** **input** {#metric}

One report definition.

### Type

#### [`ReportResult`](/docs/developers/api-reference/management/v1/types/objects/report-result) **object**

Complete aggregate results for the selected filters; excessive group counts fail instead of being truncated.
