---
id: invoice-report
title: invoiceReport
---

Count invoice records using the same filters as exports. Requires reports:read and finance:read.

```graphql
invoiceReport(
  filter: InvoiceFilter
  metric: InvoiceReportInput!
): ReportResult
```

### Arguments

#### [`invoiceReport.filter`](#filter) · [`InvoiceFilter`](/docs/developers/api-reference/management/v1/types/inputs/invoice-filter) **input** {#filter}

Source filters applied before aggregation.

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