---
id: customer-report
title: customerReport
---

Count customer records using the same filters as exports. Requires reports:read and contacts:read.

```graphql
customerReport(
  filter: CustomerFilter
  metric: CustomerReportInput!
): ReportResult
```

### Arguments

#### [`customerReport.filter`](#filter) · [`CustomerFilter`](/docs/developers/api-reference/management/v1/types/inputs/customer-filter) **input** {#filter}

Source filters applied before aggregation.

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

Grouping and count aggregation.

### 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.