Retrieve Category Totals

Provides a customer’s total income and expenditure for each category and subcategory, over a given time period.

Each income and expenditure total is separated by currency, as we cannot sum totals in different currencies.

Deprecation:

Support will cease for this endpoint on the 1st of December 2023 - please complete your migration to the Retrieve Category Totals V2 endpoint by that point in time. For further details, contact your Bud account manager or email [email protected].

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Headers
string
required

The API Client Identifier (Service Application Identifier).

uuid
required

Bud Customer identifier

string

The Bud Customer secret used to encrypt customer data. This is optional only if the customer secret is already stored with Bud (i.e. the host_secret was set to true in the Customer Context when the customer was created).

string

The date from when results are to be retrieved in the format ISO-8601.

When ommited from the request, a default value of 30 days from before today's date will be used.

Example: 2022-02-28

string

The date up to when results are to be retrieved in the format ISO-8601.

When ommited from the request, a default value of today's date will be used.

Example: 2022-01-28

Responses

401

An unauthenticated request was received

405

The request uses an unexpected HTTP method

5XX

An unexpected error occurred on the server side

Language
Credentials
OAuth2
LoadingLoading…
Response
Choose an example:
application/json