---
title: "Get Customer Finance Stats"
method: GET
path: "/customers/{customer_uid}/finance/stats"
---

# Get Customer Finance Stats

`GET /customers/{customer_uid}/finance/stats`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/customers/{customer_uid}/finance/stats`
- Auth: API key in header `x-api-key`

Returns financial summary stats for a customer: approved estimate value, invoiced amount, collected amount, bad debt, and derived rates. collected_amount is computed from PaymentTransaction rows (SUCCESS and PARTIALLY_REFUNDED) scoped to the exact invoice/estimate ids involved, net of surcharge and refunds. Also returns the raw payment transaction list.

## Path parameters

- `customer_uid` string, required

## Response `200`

200

- object
  - `type` string
  - `data` object
    - `customer` object
    - `stats` object
      - `approved_amount` number
      - `invoiced_amount` number
      - `amount_left_to_invoice` number
      - `collected_amount` number
      - `balance_amount` number
      - `invoiced_rate` number: invoiced_amount / approved_amount * 100, 0 if approved_amount is 0.
      - `collection_rate` number: collected_amount / invoiced_amount * 100, 0 if invoiced_amount is 0.
      - `bad_debt_amount` number
    - `payments` object[]

## Other responses

- `400`: 400
- `404`: 404

## Changes

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

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/customers/:customer_uid/finance/stats/get.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)