Skip to main content

invoices query — optional filters by invoice numbers

Summary​

The invoices query has a new optional argument filters, of type InvoicesQueryFilters. It currently supports invoiceNumbers: an array of integers. When provided, only invoices whose invoiceNumber is in that list are returned (together with the existing dateRange, pagination, and options behaviour).

Example​

query InvoicesByNumbers($invoiceNumbers: [Int!]) {
  invoices(
    dateRange: { start: "2026-01-01", end: "2026-12-31" }
    pagination: { page: 1, pageSize: 50 }
    options: {}
    filters: { invoiceNumbers: $invoiceNumbers }
  ) {
    data {
      id
      invoiceNumber
    }
    pageInfo {
      hasMore
    }
  }
}

Integration guidance​

  • Omitting filters: Same behaviour as before.
  • Empty invoiceNumbers: Omit the field or pass an empty list; no restriction by invoice number is applied (the resolver only applies the filter when the array is non-empty).

See also​