---
title: "Get all savings goals"
method: GET
path: "/api/v2/account/{accountUid}/savings-goals"
tags: ["Savings Goals"]
---

# Get all savings goals

`GET /api/v2/account/{accountUid}/savings-goals`

## Request

- Base URL: `https://api.starlingbank.com`
- URL: `https://api.starlingbank.com/api/v2/account/{accountUid}/savings-goals`
- Auth: HTTP bearer

## Path parameters

- `accountUid` string, uuid, required

## Response `200`

Successful operation

- SavingsGoalsV2: A list containing all savings goals for account holder
  - `savingsGoalList` SavingsGoalV2[], required
    - `savingsGoalUid` string, uuid, required: Unique identifier of the savings goal
    - `name` string, required: Name of the savings goal
    - `target` CurrencyAndAmount: Representation of money
      - `currency` string, required: ISO-4217 3 character currency code
      - `minorUnits` integer, required: Amount in the minor units of the given currency; eg pence in GBP, cents in EUR
    - `totalSaved` CurrencyAndAmount, required: Representation of money
      - `currency` string, required: ISO-4217 3 character currency code
      - `minorUnits` integer, required: Amount in the minor units of the given currency; eg pence in GBP, cents in EUR
    - `savedPercentage` integer: Percentage of target currently deposited in the savings goal
    - `state` 'CREATING' | 'ACTIVE' | 'ARCHIVING' | 'ARCHIVED' | 'RESTORING' | 'PENDING', required: The state of the savings goal

## Other responses

- `4xx`: Client error. See [API status codes](#api-status-codes-1) for more details.
- `5xx`: Server error. See [API status codes](#api-status-codes-1) for more details.

## Changes

- **2026-05-20** `10e2d804aaab`: 3 info
  - the response property `savingsGoalList/items/name` became required for the status `200`
  - the response property `savingsGoalList/items/savingsGoalUid` became required for the status `200`
  - the response property `savingsGoalList/items/totalSaved` became required for the status `200`

[Operation history](https://skmtc.dev/starlingbank/apis/starling-bank-api/changes/api/v2/account/:accountUid/savings-goals/get.md)

---

[API](https://skmtc.dev/starlingbank/apis/starling-bank-api.md) - [All operations](https://skmtc.dev/starlingbank/apis/starling-bank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlingbank/apis/starling-bank-api/revisions/7c5075cfbe63?raw)