Past due
Customers in dunning and the MRR they carry, the slice of the book most at risk.
GET/api/v1/past-due
Every customer whose subscription the billing source reports as past due, with the current MRR each one carries. This revenue still counts in your MRR, since a customer in dunning is not churned, but it is the part most likely to become churn. The same numbers back the Risk Radar in the dashboard.
Entries are sorted by MRR, biggest first, and the whole list comes in one response, so there are no pagination parameters.
Response fields
| total-mrr integer | Sum of the entries' mrr, in cents. The MRR currently sitting on past-due customers. |
| entries[].external_id string | The customer id from your billing source. |
| entries[].name string | null | Customer name. |
| entries[].email string | null | Dropped in privacy mode, see the callout below. |
| entries[].country string | null | ISO 3166-1 alpha-2 code. |
| entries[].mrr integer | That customer's current MRR, in cents. |
| has_more boolean | Always false. The whole list comes in one response. |
Privacy mode applies here exactly as on the customers list: anonymized workspaces drop the
email field and carry "anonymized": true in its place.curl https://kometrics.com/api/v1/past-due \
-H "Authorization: Bearer ko_your_api_key"