Skip to Content

Cashflow

All endpoints are scoped to a customer and require the customers:read scope.

Get cashflow

GET /api/v1/business/customers/{userId}/cashflow

Returns income, expense and remaining over the smallest-granularity window.

Query paramTypeDescription
granularitystringweekly · fortnightly · monthly · quarterly · annual · fixed_period
startDatestringWindow anchor, YYYY-MM-DD

Get reference date

GET /api/v1/business/customers/{userId}/cashflow/reference-date

Returns referenceDate, incomeGranularity, expenseGranularity, combinedGranularity.

Update granularity settings

POST /api/v1/business/customers/{userId}/cashflow/granularity-settings
Body fieldTypeDescription
incomeGranularitystringOne of the granularity values
expenseGranularitystringOne of the granularity values

Provide at least one.

See the Cashflow API guide for full examples.