Transaction volume breakdown over time

Volume + count grouped by tag or type, split into time buckets across the fromDate..toDate range. Granularity is auto-picked: >6 months → month, >30 days → week, otherwise day. Empty periods are returned as zero-filled buckets so the frontend gets a complete x-axis. Same filter set as /transactions and /transactions/breakdown. fromDate and toDate are required.

groupBy'tag' | 'type' required

Field to group breakdown analytics by.

Group by tag or type

typestring nullable

Comma-separated transaction types

incomeOnlyboolean nullable

tagstring nullable

Comma-separated tags

statusstring nullable

Comma-separated unified statuses

contactIdstring nullable

Comma-separated contact UUIDs

bank_account_idstring nullable

Comma-separated bank account UUIDs

bankAccountIdstring nullable

Comma-separated bank account UUIDs

cardIdstring nullable

Comma-separated Card UUIDs

fromDatestring date-time nullable

toDatestring date-time nullable

qstring nullable

Free-text search across description, merchant, tag, hash/wallet, contact name, counterparty user, invoice contractor, IBAN, and exact amount. Min 2 chars; values shorter are ignored.

x-api-keystring nullable

Response

Successful Response

groupBy'tag' | 'type' required

Field to group breakdown analytics by.

granularity'day' | 'week' | 'month' required

Time bucket size for the breakdown series.

v3

Transaction volume breakdown over time

Query parameters

Headers

Response