---
id: custom-field-value-report
title: customFieldValueReport
---

Count custom field value records using the same filters as exports. Requires reports:read and custom-fields:read.

```graphql
customFieldValueReport(
  filter: CustomFieldValueFilter
  metric: CustomFieldValueReportInput!
): ReportResult
```

### Arguments

#### [`customFieldValueReport.filter`](#filter) · [`CustomFieldValueFilter`](/docs/developers/api-reference/management/v1/types/inputs/custom-field-value-filter) **input** {#filter}

Source filters applied before aggregation.

#### [`customFieldValueReport.metric`](#metric) · [`CustomFieldValueReportInput!`](/docs/developers/api-reference/management/v1/types/inputs/custom-field-value-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.