Failure rate summary
The /reports/cashflow-failure-rate-summary endpoint returns failure rate and recovery rate for month-to-date and year-to-date periods with comparisons to prior equivalent periods.
GET /reports/cashflow-failure-rate-summary
Query parameters
| Parameter | Type | Description |
|---|
baseCurrency | string | Target currency for conversion. Defaults to account base currency. |
fix_fx | boolean | Use fixed exchange rates. |
region | string | Filter by region or country codes (space-separated). |
currency | string | Filter by currency codes (space-separated). |
plan | string | Filter by plan group IDs (space-separated). |
data_source | string | Filter by data source ID (space-separated). |
Example response
200 OK
{
"currency": "usd",
"summary": {
"mtd_failed_pct": 3.2,
"prev_mtd_failed_pct": 4.1,
"ytd_failed_pct": 3.5,
"prev_ytd_failed_pct": 4.0,
"mtd_recovery_rate": 75.0,
"prev_mtd_recovery_rate": 68.0,
"ytd_recovery_rate": 72.5,
"prev_ytd_recovery_rate": 65.0,
"mtd_failed_invoices": 8,
"prev_mtd_failed_invoices": 12,
"ytd_failed_invoices": 45,
"prev_ytd_failed_invoices": 55,
"mtd_failed_pct_change": -0.9,
"ytd_failed_pct_change": -0.5,
"mtd_recovery_rate_change": 7.0,
"ytd_recovery_rate_change": 7.5
}
}
Response fields
| Field | Type | Description |
|---|
mtd_failed_pct | float | Month-to-date failure percentage |
prev_mtd_failed_pct | float | Previous month failure percentage |
ytd_failed_pct | float | Year-to-date failure percentage |
prev_ytd_failed_pct | float | Previous year failure percentage |
mtd_recovery_rate | float | Month-to-date recovery rate (%) |
prev_mtd_recovery_rate | float | Previous month recovery rate (%) |
ytd_recovery_rate | float | Year-to-date recovery rate (%) |
prev_ytd_recovery_rate | float | Previous year recovery rate (%) |
mtd_failed_invoices | integer | Month-to-date failed invoice count |
prev_mtd_failed_invoices | integer | Previous month failed invoice count |
ytd_failed_invoices | integer | Year-to-date failed invoice count |
prev_ytd_failed_invoices | integer | Previous year failed invoice count |
*_change | float | Absolute change vs prior period |
