Authentication

OAuth2
- OAuth2post

Customers API

Manage Customers

Connect API

Create a Connection
Manage a Connection
Ingest First Party Data

Financial Data API

Retrieve Financial Data
Correct Financial Data

Enrichment API

Enrichment Totals
Enrichment Resources

Smart Finders API

Regular Payments Finder
- Retrieve Regular Transactionsget
- Retrieve Future Forecasted Transactions V2get
Income Finder
Loan Finder
- Retrieve Loan Transactionsget
Debt Collection Finder
- Retrieve Debt Collection Transactionsget
Product Finder
- Retrieve Financial Products V2get
Subscription Finder
- Retrieve Subscriptionsget

Goals API

Savings Goals
Spending Budgets

Insights API

Retrieve Actionable Insights
Custom Insights
Frontend Widgets

Characteristics API

Retrieve Customer Characteristics

Intelligent Search API

Transaction Search

Assess API

Customer Applications
Customer Application Links
- Retrieve Customer Application URLpost
Aggregation Buckets
Retrieve Affordability Report
Retrieve Affordability Report V2
- Retrieve Affordability Report V2get
Retrieve Affordability Risk Insights

Retrieve Savings Goal Actions

get https://api-sandbox.thisisbud.com/goals/v1/savings/{goal_id}/actions

Retrieve all savings goal actions for the given goal_id. The results of this endpoint are paginated with a default page size of 100 and a maximum of 200.
The page size is configurable by the page_size query parameter.
The next page of results can be retrieved using the page_token query parameter.

Path Params

goal_id

string

required

The ID of the savings goal.

Example: 81a68821-dca6-4771-80d4-002c7fce412e

Query Params

page_token

string

Use this paramater to fetch a specific page of results. Provided by the next_page_token field in the previous request.

page_size

integer

Use this parameter to set the maximum number of results to be returned. This defaults to 100, and has a maximum of 200.

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.

Responses

Response body

object

operation_id

string

required

goals_v1_savings_actions_get

data

array of objects

required

data*

object

string

required

The ID of the savings goal action.

Example: "81a68821-dca6-4771-80d4-002c7fce412e"

amount

object

required

The amount of money saved towards the savings goal.

credit_debit_indicator

string

required

The credit/debit indicator of the amount. This indicates whether the amount has been added to or subtracted from the savings goal.

Example: credit

credit debit

created_at

string

required

The date and time the savings goal action was created in the format RFC-3339.

Examples:

2023-01-17T17:29:51Z
2023-01-17T17:29:51-08:00

metadata

object

required

results

integer

required

The number of results returned in the response.

Example: 1

goal_id

string

The ID of the savings goal the actions were retrieved for.

Example: "81a68821-dca6-4771-80d4-002c7fce412e"

next_page_token

string

The token to use to fetch the next page of results. This is only set if there are more results to fetch.

Response body

object

operation_id

string

required

A unique identifier/reference associated with a given endpoint/operation

code_id

string

required

A descriptive enough string that is linked to the reason for the error.

message

string

required

errors

required

Response body

object

operation_id

string

required

A unique identifier/reference associated with a given endpoint/operation

code_id

string

required

A descriptive enough string that is linked to the reason for the error.

message

string

required

An actual user friendly error message.

errors

Response body

object

operation_id

string

required

A unique identifier/reference associated with a given endpoint/operation

code_id

string

required

A descriptive enough string that is linked to the reason for the error.

message

string

required

An actual user friendly error message.

errors

Response body

object

operation_id

string

required

A unique identifier/reference associated with a given endpoint/operation

code_id

string

required

A descriptive enough string that is linked to the reason for the error.

message

string

required

An actual user friendly error message.

errors

Updated over 1 year ago

Create Savings Goal Action

Update Savings Goal Action

Did this page help you?

Language

Credentials

OAuth2

Bearer


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api-sandbox.thisisbud.com/goals/v1/savings/goal_id/actions \
3
     --header 'accept: application/json'

Choose an example:

application/json

Updated over 1 year ago

Create Savings Goal Action

Update Savings Goal Action

Did this page help you?

Authentication
OAuth2
OAuth2post

Customers API
Manage Customers
Update Customer Contextput
Retrieve Customer Contextget
Retrieve Remove Customer V3 Statusget
Remove Customer V3delete
Create Customers V3 (Batch)post
Retrieve Customers V3get
Create Customer V3post

Connect API
Create a Connection
Retrieve Connection Statusget
Retrieve Authorisation Gateway URL (v2)post
Retrieve Bank Providersget
Manage a Connection
Retrieve Revoke Consent Statusget
Initiate Revoke Consentpost
Retrieve Customer Consentsget
Retrieve Refresh Status V2get
Initiate Refresh V2post
Retrieve Refresh Statusget
Initiate Refreshpost
Ingest First Party Data
Retrieve Ingestion Task Statusget
Decline Transactionspost
Book Transactionspost
Ingest Transactionspost
Ingest Accountspost

Financial Data API
Retrieve Financial Data
Retrieve Enriched Transactions V2get
Retrieve Account By ID V2get
Retrieve Balances Over Time By Account V3get
Retrieve Balances Over Time V3get
Retrieve Balances Over Time By Accountget
Retrieve Balances Over Timeget
Retrieve Accounts V2get
Retrieve Account By ID V3get
Retrieve Accounts V3get
Correct Financial Data
Suggests changes to a merchantpost
Similar Transactions Including Merchantsget
Similar Transactionsget
Fetch custom merchants for customerget
Create a new custom merchantpost
Correction Merchant Searchget
Correct Transaction Merchantpost
Correct Transaction Categories V2post

Enrichment API
Enrichment Totals
Retrieve Merchant Totals V2get
Retrieve Statistics For Essential Total Spendget
Retrieve Category Totals Trendsget
Retrieve Category Totals V2get
Enrichment Resources
Retrieve Categoriesget
Retrieve Categories V2get
Retrieve Available Categorisation Models V2get

Smart Finders API
Regular Payments Finder
Retrieve Future Forecasted Transactions V2get
Retrieve Regular Transactionsget
Income Finder
Retrieve Benefits Totalsget
Retrieve Benefits Transactionsget
Retrieve Income Transactions V2get
Loan Finder
Retrieve Loan Transactionsget
Debt Collection Finder
Retrieve Debt Collection Transactionsget
Product Finder
Retrieve Financial Products V2get
Subscription Finder
Retrieve Subscriptionsget

Goals API
Savings Goals
Remove Savings Goal Actiondelete
Update Savings Goal Actionpatch
Retrieve Savings Goal Actionsget
Create Savings Goal Actionpost
Remove Savings Goaldelete
Update Savings Goalpatch
Remove All Savings Goalsdelete
Retrieve Savings Goalsget
Create Savings Goalpost
Spending Budgets
Retrieve Spending Budget Transactionsget
Delete a Spending Budgetdelete
Patch a Spending Budgetpatch
Delete all Spending Budgetsdelete
Retrieve Spending Budgetsget
Create Spending Budgetpost

Insights API
Retrieve Actionable Insights
Retrieve Spending Actionable Insight Detailsget
Retrieve Spending Actionable Insightsget
Retrieve Income Actionable Insight Detailsget
Retrieve Income Actionable Insightsget
Retrieve Balances Actionable Insight Detailsget
Retrieve Balances Actionable Insightsget
Custom Insights
Retrieve custom insights profileget
Build custom insights profilepost
Delete all existing custom insightsdelete
Update existing custom insightpatch
Delete existing custom insightdelete
Detail the transactions used to generate a custom insightget
List existing custom insightsget
Create new custom insightpost
Frontend Widgets
Generate Spending Analysis URLpost
Generate Recurring and Forecasted Transactions URLpost
Generate Balances Over Time URLpost
Generate Financial Calendar URLpost
Generate Card Summary URLpost

Characteristics API
Retrieve Customer Characteristics
Retrieve Customer Characteristics - Saverget
Retrieve Customer Characteristics - Overdraftget
Retrieve Customer Characteristics - Loanget
Retrieve Customer Characteristics - Credit Cardget
Retrieve Customer Characteristicsget

Intelligent Search API
Transaction Search
Get transactions used by the search insight.get
Get transaction search insight.get
Get transaction search by ID.get
Search customer transactions.get
Create Intelligent Search Frontend Widget URLpost

Assess API
Customer Applications
Delete Customer Applicationdelete
Retrieve Customer Applicationget
Retrieve Customer Applicationsget
Create Customer Applicationpost
Customer Application Links
Retrieve Customer Application URLpost
Aggregation Buckets
Retrieve Bucket Totalsget
Delete Bucketsdelete
Update Bucketput
Retrieve Bucketget
Retrieve All Bucketsget
Create Bucketspost
Retrieve Affordability Report
Retrieve Affordability Transactions V2get
Retrieve Affordability Transactionsget
Retrieve Affordability Reportget
Retrieve Affordability Report V2
Retrieve Affordability Report V2get
Retrieve Affordability Risk Insights
Retrieve transactions relating to a specific insight report section.get
Retrieve a health report on a customers financial profile.get
Retrieve transactions relating to a specific insight report section.get
Retrieve a report on a customers unauthorised overdraft.get
Retrieve transactions relating to a specific insight report section.get
Retrieve merchant-specific breakdown reports.get
Retrieve transactions relating to a specific insight report section.get
Retrieve income/expenditure break down reportsget

200OK - The goal actions were retrieved successfully.

400The request contains an invalid payload.

401Unauthorized - The request was not authorised.

404Not Found - The goal ID could not be found.

500Internal Server Error - An unexpected error occurred.