---
title: "Get an invoice summary"
method: GET
path: "/invoices/summary"
tags: ["Invoices"]
---

# Get an invoice summary

`GET /invoices/summary`

Returns aggregate invoice totals (count and gross total) grouped by currency for the invoices matching the supplied filters. Totals cover the whole matching set, so accurate figures can be retrieved in a single request without paginating.

## Query parameters

- `invoiceStatus` string
- `invoicePaymentStatus` string
- `customerId` string
- `billingScheduleId` string
- `dueBefore` string
- `dueAfter` string
- `sentBefore` string
- `sentAfter` string
- `invoiceBefore` string
- `invoiceAfter` string
- `excludeZeroQuantity` boolean
- `invoiceCurrency` string
- `search` string
- `invoiceNumber` string
- `netTotal` number

## Headers

- `Authorization` string, required
- `sequence-version` '2024-07-30'

## Response `200`

OK

- InvoiceSummaryResponse
  - `totalsByCurrency` InvoiceSummaryResponseCurrencyTotals[], required — Aggregate totals for the invoices matching the supplied filters, grouped by currency.
    - `currency` 'AED' | 'ARS' | 'AUD' | 'BRL' | 'BGN' | 'CAD' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CZK' | 'DKK' | 'EGP' | 'EUR' | 'GBP' | 'HKD' | 'ILS' | 'INR' | 'ISK' | 'JPY' | 'KRW' | 'MXN' | 'NOK' | 'NZD' | 'PLN' | 'SAR' | 'SEK' | 'SGD' | 'THB' | 'USD' | 'UYU' | 'ZAR', required
    - `invoiceCount` integer, required — The number of invoices matching the filters in this currency.
    - `grossTotal` number, required — The sum of the gross totals of the matching invoices in this currency.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

## Changes

> 714 revisions in range; 418 could not be searched.

- **2026-06-17** `d01512162768` — 9 warning, 1 info
  - deleted the `header` request parameter `Sequence-Version`
  - deleted the `query` request parameter `excludeBillingScheduleId`
  - deleted the `query` request parameter `excludeCustomerId`
  - deleted the `query` request parameter `excludeInvoiceCurrency`
  - …6 more
- **2026-06-16** `12ab2101be2a` — 1 warning, 9 info
  - deleted the `header` request parameter `sequence-version`
  - added the new optional `header` request parameter `Sequence-Version`
  - added the new optional `query` request parameter `excludeBillingScheduleId`
  - added the new optional `query` request parameter `excludeCustomerId`
  - …6 more
- **2026-06-16** `c5cfe471a2b3` — 9 warning, 1 info
  - deleted the `header` request parameter `Sequence-Version`
  - deleted the `query` request parameter `excludeBillingScheduleId`
  - deleted the `query` request parameter `excludeCustomerId`
  - deleted the `query` request parameter `excludeInvoiceCurrency`
  - …6 more
- **2026-06-12** `c7fc5367a6cd` — 8 info
  - added the new optional `query` request parameter `excludeBillingScheduleId`
  - added the new optional `query` request parameter `excludeCustomerId`
  - added the new optional `query` request parameter `excludeInvoiceCurrency`
  - added the new optional `query` request parameter `excludeInvoiceNumber`
  - …4 more

[Change history](https://skmtc.dev/sequencehq/apis/sequence/changes/invoices/summary/get.md)

---

[API](https://skmtc.dev/sequencehq/apis/sequence.md) · [All operations](https://skmtc.dev/sequencehq/apis/sequence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequencehq/sequence/revisions/e520d2f95b7b/schema)