ALaltoviz
Statistics

How long payments actually take over a period: average and median days from the document date and from the due date, plus the share paid late

Changed on

Answers "do my customers pay me on time, and how late are they?". Read the medians rather than the averages — the mean is dragged by a small tail of very late payers, so it can report a month's delay where the typical invoice is paid on time.

get/v1/statistics/paymentdelay

Request

Query parameters

fromstring date

First day of the period. Combined with to, takes precedence over year.

tostring date

Last day of the period, included

yearinteger

Shorthand for a whole calendar year (defaults to the current one). Ignored when a range is given.

periodicity'Daily' | 'Weekly' | 'Monthly' | 'Quarterly' | 'Annually'

Bucket size: Daily, Weekly, Monthly (default), Quarterly or Annually

side'Customers' | 'Suppliers'

Which side of the ledger a payment delay is measured on

Customers (default) or suppliers

Response

OK

lateSharenumber double

Share of the settled amount paid after its due date, 0..1

medianDaysLatenumber double nullable

Median days from due date to payment. Null when nothing settled

medianDaysToPaymentnumber double nullable

Median days from document date to payment. Null when nothing settled

settledAmountnumber double

Total settled over the period

Changes