---
title: "Aged balance of money owed by customers, bucketed by how far each échéance is from today"
method: GET
path: "/v1/statistics/unpaidinvoices"
tags: ["Statistics"]
---

# Aged balance of money owed by customers, bucketed by how far each échéance is from today

`GET /v1/statistics/unpaidinvoices`

## Request

- Base URL: `https://api.altoviz.com`
- URL: `https://api.altoviz.com/v1/statistics/unpaidinvoices`
- Auth: none required
- TypeScript: <https://skmtc.dev/altoviz/apis/altoviz-api/docs/v1/statistics/unpaidinvoices/get.ts> (a function with typed inputs; its response is checked against the schema)

Answers "who owes me money, and how late is it?" as totals per age bucket.

## Response `200`

OK

- UnpaidCommitmentBucket[]
  - `count` integer: Number of échéances in this bucket
  - `period` integer: Negative is overdue, 0 is due today, positive is upcoming. -7 is more than 90 days late, 7 more than 90 days ahead; the steps in between are 1, 7, 15, 30, 60 and 90 days.
  - `total` number, double: Amount still due in this bucket

## Changes

- **2026-09-14** `4f7fa64cf9e3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/altoviz/apis/altoviz-api/changes/v1/statistics/unpaidinvoices/get.md)

---

[API](https://skmtc.dev/altoviz/apis/altoviz-api.md) - [All operations](https://skmtc.dev/altoviz/apis/altoviz-api/llms.txt) - [OpenAPI document](https://skmtc.dev/altoviz/apis/altoviz-api/revisions/4f7fa64cf9e3?raw)