STstarlingbank
Spaces

Get a spending space

Changed on
get/api/v2/account/{accountUid}/spaces/spending/{spaceUid}

Request

Path parameters

accountUidstring uuid required
Example:aaaaaaaa-aaaa-4aaa-aaaa-aaaaaaaaaaaa

Account uid

spaceUidstring uuid required
Example:aaaaaaaa-aaaa-4aaa-aaaa-aaaaaaaaaaaa

Spending space uid

Response

Successful operation

spaceUidstring uuid required

SpendingSpaceUid

namestring required

Name of the space

cardAssociationUidstring uuid

Card Association Uid

sortOrderinteger

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

Example response

{
  "spaceUid": "aaaaaaaa-aaaa-4aaa-aaaa-aaaaaaaaaaaa",
  "name": "Shopping",
  "balance": {
    "currency": "GBP",
    "minorUnits": 123456
  },
  "cardAssociationUid": "aaaaaaaa-aaaa-4aaa-aaaa-aaaaaaaaaaaa",
  "state": "ACTIVE"
}

Changes

  • 7c5075cfbe63Revision changes
    • warning

      added the new CONNECTED enum value to the response property for the response status

    • warning

      added the new U16 enum value to the response property for the response status

    • info

      removed the CHILDCARE enum value from the response property for the response status

    • info

      removed the CHILDCARE_V2 enum value from the response property for the response status

    • info

      removed the HELPING_OUT enum value from the response property for the response status

    • info

      removed the SHOPPING enum value from the response property for the response status

    • info

      removed the SHOPPING_V2 enum value from the response property for the response status

    • info

      removed the SPARE enum value from the response property for the response status

    • info

      removed the SPARE_CARD enum value from the response property for the response status

    • info

      removed the YOUNG_PERSON enum value from the response property for the response status

  • 10e2d804aaabRevision changes
    • breaking

      the response property became optional for the status

    • info

      removed the optional write-only property uid from the response with the status