---
id: invoices
title: invoices
---

Lists invoices, including discards where supported. Requires finance:read.

```graphql
invoices(
  after: String
  filter: InvoiceFilter
  first: Int = 100
  updatedSince: DateTime
): InvoiceCollection!
```

### Arguments

#### [`invoices.after`](#after) · [`String`](/docs/developers/api-reference/management/v1/types/scalars/string) **scalar** {#after}

Opaque cursor from the previous page of this collection and filter.

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

Optional record and relationship filters.

#### [`invoices.first`](#first) · [`Int`](/docs/developers/api-reference/management/v1/types/scalars/int) **scalar** {#first}

Page size, clamped to 1–100.

#### [`invoices.updatedSince`](#updated-since) · [`DateTime`](/docs/developers/api-reference/management/v1/types/scalars/date-time) **scalar** {#updated-since}

Inclusive modification timestamp for synchronization.

### Type

#### [`InvoiceCollection`](/docs/developers/api-reference/management/v1/types/objects/invoice-collection) **object**

A page of invoices with continuation information.