---
title: "Customers with overdue échéances, ranked by outstanding amount"
method: GET
path: "/v1/statistics/topoverduecustomers"
tags: ["Statistics"]
---

# Customers with overdue échéances, ranked by outstanding amount

`GET /v1/statistics/topoverduecustomers`

## Request

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

Answers "who should I chase first?". Includes the age of each customer's oldest unpaid
échéance and when they were last reminded, so "never chased" can be told from "chased and
still not paying".

## Query parameters

- `take` integer

## Response `200`

OK

- OverdueCustomer[]
  - `customerId` integer: Customer identifier
  - `customerName` string, nullable: Customer name at the time of the query
  - `invoiceCount` integer: How many échéances make up the amount
  - `lastReminderOn` string, date-time, nullable: Most recent reminder sent to this customer, or null if never chased
  - `oldestOverdueDays` integer: Age in days of the oldest unpaid échéance
  - `overdueAmount` number, double: Sum still due on échéances past their date

## Changes

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

[Operation history](https://skmtc.dev/altoviz/apis/altoviz-api/changes/v1/statistics/topoverduecustomers/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)