---
title: "Get Invoices Summary (Kanban)"
method: POST
path: "/invoice/summary"
---

# Get Invoices Summary (Kanban)

`POST /invoice/summary`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/invoice/summary`
- Auth: API key in header `x-api-key`

Groups all invoices matching the given filter by invoice_status and returns counts/totals per status. Always zero-fills all 9 statuses (DRAFT, READY_TO_INVOICE, AWAIT_PAYMENT, PARTIALLY_PAID, PAID, BAD_DEBT, ARCHIVED, CLOSED, CANCELED) even when empty — unlike the analogous Estimate endpoint, no status is ever filtered out. Amounts rounded to the company's decimal_roundoff config.

## Request body

- object
  - `sort` 'ASC' | 'DESC'
  - `sort_by` 'created_at' | 'updated_at' | 'invoice_date' | 'due_date' | 'total' | 'amount_paid' | 'amount_due'
  - `filter_rules` object[]
  - `filter_rule_operator` 'AND' | 'OR'
  - `preferred_timezone` string

## Response `200`

200

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/invoice/summary/post.md)

---

[API](https://skmtc.dev/zuper/apis/zuper-pro-api.md) - [All operations](https://skmtc.dev/zuper/apis/zuper-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zuper/apis/zuper-pro-api/revisions/3c21bc232e16?raw)