Retrieve Savings Goal Actions

The GET goals/v1/savings/{goal_id}/actions endpoint retrieves all actions for a customer's savings goal.

This endpoint is paginated with a maximum page size of 200 and a default of 100, this can be set via the page_size query parameter. If more pages are available, then a page_token field will be present in the metadata of the response. The value of this field should be put in the page_token query parameter to fetch the next page if results.

Below is an example response with a page_token indicating there is a further page of actions available.

{
  "operation_id": "goals_v1_savings_actions_get",
  "data": [
    {
      "id": "23267253-5860-11ee-99e5-9ed0600d2630",
      "amount": {
        "currency": "GBP",
        "value": "10.00"
      },
      "credit_debit_indicator": "credit",
      "created_at": "2023-09-21T09:20:42Z"
    },
    {
      "id": "23267253-5860-11ee-99e5-9ed0600d2630",
      "amount": {
        "currency": "GBP",
        "value": "10.00"
      },
      "credit_debit_indicator": "credit",
      "created_at": "2023-09-21T09:20:42Z"
    }
  ],
  "metadata": {
    "results": 2,
    "page_token": "b21055a9a9f46fc794a2e6855c65abd7e317181039fc6930daabac5822911d14a84895ecd947e2b5abdcb22e4fcc2c594e1f661dc63e34b9ba88760724047990896f7581a0786c2605dce19c6a9d80d1044f963b74fea0a929c0a4465a6e67378a74dce38ec5e26ae4cc804b62fd666d5df4cf2e7f524bd99e5523bc5d471768065c036dc0c73122705b280817fbbd7d9aa31f271d72cd3877d999dcb9a5b1c0be0c05",
    "page_size": 100,
    "goal_id": "19d1def3-5860-11ee-9342-3e1d60bc76f9"
  }
}

curl --request GET \
     --url https://api-sandbox.thisisbud.com/goals/v1/savings/goal_id/actions \
     --header 'X-Client-Id: ecfa9b53-963b-4f8a-9811-e09a79ff7019' \
     --header 'X-Customer-Id: 2a7a1f1c-18b9-4af1-8424-91c5848e8037' \
     --header 'X-Customer-Secret: 2efbed02ac697a80354e0a792bbe733aed904820d030321a0b50b51c1dd05bd3' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer dddd'

In the case that there are no further pages of results, the page_token in the metadata will be empty.

{
  "operation_id": "goals_v1_savings_actions_get",
  "data": [..],
  "metadata": {
    "results": 2,
    "page_token": "",
    "page_size": 100,
    "goal_id": "19d1def3-5860-11ee-9342-3e1d60bc76f9"
  }
}

If you receive a 400 response, please check the headers you're sending in the request before trying again.

If you receive a 401 response from either of the endpoints this would indicate that you are not authorised to make this request, if you believe this to be a mistake or are receiving persistent 500 responses please raise a support request.

If you have any questions, please contact us via the chatbot (bottom-right of screen 👉) or via a support request or check our FAQs.