---
id: address-report
title: addressReport
---

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

```graphql
addressReport(
  filter: AddressFilter
  metric: AddressReportInput!
): ReportResult
```

### Arguments

#### [`addressReport.filter`](#filter) · [`AddressFilter`](/docs/developers/api-reference/management/v1/types/inputs/address-filter) **input** {#filter}

Source filters applied before aggregation.

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