---
id: contact-report
title: contactReport
---

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

```graphql
contactReport(
  currency: String
  filter: ContactFilter
  metric: ContactReportInput!
): ReportResult
```

### Arguments

#### [`contactReport.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.

#### [`contactReport.filter`](#filter) · [`ContactFilter`](/docs/developers/api-reference/management/v1/types/inputs/contact-filter) **input** {#filter}

Filter the complete source dataset before aggregation.

#### [`contactReport.metric`](#metric) · [`ContactReportInput!`](/docs/developers/api-reference/management/v1/types/inputs/contact-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.