Retrieve Transactions V2

get

https://api-sandbox.thisisbud.com/financial/v2/transactions

List the Transactions for a customer across all ingestion sources and accounts. Ordered by date_time and then transaction_id descending.

They are also provided with Enrichments - contextual information generated by Bud's artificial intelligence models. Enrichments are optional because not all Enrichments are relevant to all Transactions, or because they did not have enough information to generate enrichments (e.g. pending Transactions).

The Enrichment process also generates tags, which can be used for filtering using the include_tags and exclude_tags query parameters.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

date_from

string

Date (RFC3339) from which the transactions should be returned from. To maintain backwards compatibility, dates in the format (YYYY-MM-DD) can also be used and will be assumed to be UTC.

date_to

string

Date (RFC3339) from which the transactions should be returned to. To maintain backwards compatibility, dates in the format (YYYY-MM-DD) can also be used and will be assumed to be UTC. Uses the current date by default.

page_size

integer

Maximum number of results to be returned. Defaults to 100, maximum is 200

page_token

string

The token required to fetch a specific page of results. Provided by the next_page_token field in the previous request.

account_id

string

Identifier of the accounts from which transactions should be returned.

merchant

string

Human readable identifier of the merchants for which associated transactions should be returned.

category_l1

string

Identifier of the Category Level 1 for which associated transactions should be returned.

category_l2

string

Identifier of the Category Level 2 for which associated transactions should be returned.

include_tags

array of strings

Tags for which associated transactions should be returned.

include_tags

exclude_tags

array of strings

Tags for which associated transactions should not be returned.

exclude_tags

credit_debit_indicator

string

enum

Credit debit indicator for which associated transactions should be returned.

Allowed:

Headers

X-Client-Id

string

required

The API Client Identifier (Service Application Identifier).

X-Customer-Id

uuid

required

Bud Customer identifier

X-Customer-Secret

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).

Responses

401

An unauthenticated request was received.

405

The request uses an unexpected HTTP method.

5XX

An unexpected error occurred on the server side.

200The request was successfully processed.