---
title: "Retrieve account"
method: GET
path: "/accounts/{id}"
tags: ["Accounts"]
---

# Retrieve account

`GET /accounts/{id}`

Retrieve a specific account by providing its unique identifier.

## Path parameters

- `id` string, required

## Response `200`

Successful Response

- GetAccountResponse — Successful response to get a single account.
  - `data` AccountResource, required — Provides information about an Up bank account.
    - `type` string, required — The type of this resource: `accounts`
    - `id` string, required — The unique identifier for this account.
    - `attributes` object, required
      - `displayName` string, required — The name associated with the account in the Up application.
      - `accountType` 'SAVER' | 'TRANSACTIONAL' | 'HOME_LOAN', required — Specifies the type of bank account. Currently returned values are `SAVER`, `TRANSACTIONAL` and `HOME_LOAN`.
      - `ownershipType` 'INDIVIDUAL' | 'JOINT', required — Specifies the structure under which a bank account is owned. Currently returned values are `INDIVIDUAL` and `JOINT`.
      - `balance` MoneyObject, required — Provides information about a value of money.
        - `currencyCode` string, required — The ISO 4217 currency code.
        - `value` string, required — The amount of money, formatted as a string in the relevant currency. For example, for an Australian dollar value of $10.56, this field will be `"10.56"`. The currency symbol is not included in the string.
        - `valueInBaseUnits` integer, required — The amount of money in the smallest denomination for the currency, as a 64-bit integer. For example, for an Australian dollar value of $10.56, this field will be `1056`.
      - `createdAt` string, date-time, required — The date-time at which this account was first opened.
    - `relationships` object, required
      - `transactions` object, required
        - `links` object
          - `related` string, required — The link to retrieve the related resource(s) in this relationship.
    - `links` object
      - `self` string, required — The canonical link to this resource within the API.

## Changes

- **2024-08-05** (v1) `0026d0a1e76c` — 1 warning
  - added the new `HOME_LOAN` enum value to the `data/allOf[#/components/schemas/AccountResource]/attributes/accountType/allOf[#/components/schemas/AccountTypeEnum]/` response property for the response status `200`
- **2022-01-09** (v1) `aef57e5ad36b` — 1 info
  - added the required property `data/allOf[#/components/schemas/AccountResource]/attributes/ownershipType` to the response with the `200` status
- **2020-07-21** (v1) `2ac77a5de971` — 1 breaking, 1 info
  - removed the required property `data/allOf[#/components/schemas/AccountResource]/attributes/ownershipType` from the response with the `200` status
  - removed the `HOME_LOAN` enum value from the `data/allOf[#/components/schemas/AccountResource]/attributes/accountType/allOf[#/components/schemas/AccountTypeEnum]/` response property for the response status `200`

[Change history](https://skmtc.dev/up-banking/apis/up-api/changes/accounts/:id/get.md)

---

[API](https://skmtc.dev/up-banking/apis/up-api.md) · [All operations](https://skmtc.dev/up-banking/apis/up-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/up-banking/up-api/revisions/cc6a5e6d809d/schema)