---
title: "Get Invoice Stats By Filter"
method: POST
path: "/analytics/invoice"
---

# Get Invoice Stats By Filter

`POST /analytics/invoice`

## Request

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

Same aggregation/response shape as Get Invoice Stats, but selects invoices via the v3 filter_rules engine instead of fixed date/customer params. Team Leaders restricted to invoices created by their reports unless can_tl_access_all_invoices is enabled; Field Executives restricted to their own unless can_fe_access_all_invoices is enabled.

## Request body

- object
  - `filter_rules` object[]
  - `filter_rule_operator` 'AND' | 'OR'
  - `preferred_timezone` string

## Response `200`

200

- object
  - `type` string
  - `data` object
    - `no_of_invoices` integer
    - `count_by_status` object
    - `total_invoice_value` string
    - `over_due` object
      - `value` string
      - `count` integer
    - `paid` object
    - `open` object
    - `bad_debt` object
    - `partially_paid` object
    - `draft` object
    - `await_payment` object
    - `archived` object
    - `closed` object
    - `cancelled` object
    - `ready_to_invoice` object

## Changes

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

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/analytics/invoice/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)