---
title: "Get all active savings and spending spaces"
method: GET
path: "/api/v2/account/{accountUid}/spaces"
tags: ["Spaces"]
---

# Get all active savings and spending spaces

`GET /api/v2/account/{accountUid}/spaces`

## Request

- Base URL: `https://api.starlingbank.com`
- URL: `https://api.starlingbank.com/api/v2/account/{accountUid}/spaces`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/starlingbank/apis/starling-bank-api/docs/api/v2/account/:accountUid/spaces/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `accountUid` string, uuid, required

## Response `200`

Successful operation

- Spaces: A list containing all spaces for an account holder
  - `savingsGoals` SavingsGoalOrdered[], 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
    - `sortOrder` integer: Sort Order
    - `state` 'CREATING' | 'ACTIVE' | 'ARCHIVING' | 'ARCHIVED' | 'RESTORING' | 'PENDING', required: The state of the savings goal
  - `spendingSpaces` SpendingSpace[], required
    - `spaceUid` string, uuid, required: SpendingSpaceUid
    - `name` string, required: Name of the space
    - `balance` 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
    - `cardAssociationUid` string, uuid: Card Association Uid
    - `sortOrder` integer: Sort Order
    - `spendingSpaceType` 'EXPENSE' | 'U16' | 'CONNECTED', required: Spending Space Type. From 2026-10-19, SHOPPING, CHILDCARE and HELPING_OUT are replaced by CONNECTED, and YOUNG_PERSON is replaced by U16. SPARE_CARD, CHILDCARE_V2 and SHOPPING_V2 are removed on the same date (not currently returned). EXPENSE is unaffected.
    - `state` 'CREATING' | 'ACTIVE' | 'ARCHIVING' | 'ARCHIVED' | 'RESTORING' | 'PENDING', required: The state of the spending space

## 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-10-22** `7c5075cfbe63`: 2 warning, 8 info
  - added the new `CONNECTED` enum value to the `spendingSpaces/items/spendingSpaceType` response property for the response status `200`
  - added the new `U16` enum value to the `spendingSpaces/items/spendingSpaceType` response property for the response status `200`
  - removed the `CHILDCARE` enum value from the `spendingSpaces/items/spendingSpaceType` response property for the response status `200`
  - removed the `CHILDCARE_V2` enum value from the `spendingSpaces/items/spendingSpaceType` response property for the response status `200`
  - …6 more
- **2026-05-20** `10e2d804aaab`: 1 breaking, 4 info
  - the response property `spendingSpaces/items/cardAssociationUid` became optional for the status `200`
  - removed the optional write-only property `spendingSpaces/items/uid` from the response with the `200` status
  - the response property `savingsGoals/items/name` became required for the status `200`
  - the response property `savingsGoals/items/savingsGoalUid` became required for the status `200`
  - …1 more

[Operation history](https://skmtc.dev/starlingbank/apis/starling-bank-api/changes/api/v2/account/:accountUid/spaces/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)