Retrieve Accounts V2

get deprecated

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

Retrieves a list of a customer's connected accounts. The result can be filtered using the parameters outlined below.

Deprecation:

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

Query Params

currency

string

Use this parameter to filter the results returned on the currency associated with each result. Multiple values are accepted. If this parameter is not provided then results of any currency will be returned.

provider

string

Use this parameter to filter the results returned on the provider associated with each result. Multiple values are accepted. If this parameter is not provided then results of any provider will be returned.

account_type

string

Use this parameter to filter the results returned on the account_type associated with each result. Multiple values are accepted. If this parameter is not provided then results of any account_type will be returned. Currently supported values include (but are not necessarily limited to):

charge_card
credit_card
current_account
e_money
investment
loan
mortgage
other
pre_paid_card
savings

usage_type

string

Use this parameter to filter the results returned on the usage_type associated with each result. Multiple values are accepted. If this parameter is not provided then results of any usage_type will be returned. Currently supported values include (but are not necessarily limited to):

personal
business

holder_relationship_type

string

Use this parameter to filter the results returned on the holder_relationship_type associated with each result. Multiple values are accepted. If this parameter is not provided then results of any holder_relationship_type will be returned. Currently supported values include (but are not necessarily limited to):

sole
joint
delegate
unknown

Headers

X-Client-Id

string

required

The API Client Identifier (Service Application Identifier).

X-Customer-Id

uuid

required

A unique identifier for a Customer, as registered on Bud's platform.

X-Customer-Idempotent-Identifier

string

Use the internal client identifier, provided in the client_metadata object when creating the customer in Create Customer V3, in place of an X-Customer-Id header.

X-Customer-Secret

string

The Bud Customer secret used to encrypt customer data. This is required only if the customer secret is not already stored with Bud.

Responses

200OK

400The request contains an invalid payload.

401Unauthorised

500Server Error