---
title: "List current investment holdings for an account"
method: GET
path: "/v1/banks/{bid}/accounts/{aid}/holdings"
tags: ["Holdings"]
---

# List current investment holdings for an account

`GET /v1/banks/{bid}/accounts/{aid}/holdings`

## Request

- Base URL: `https://api.banksync.io`
- URL: `https://api.banksync.io/v1/banks/{bid}/accounts/{aid}/holdings`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Responses may be served from a cache up to 6 hours old: `X-BankSync-Cache` says `hit`, `miss` or `bypass`, and `Age` is the cached answer's age in seconds.

## Path parameters

- `bid` string, required: Bank ID
- `aid` string, required: Account ID

## Response `200`

Current investment positions

- object
  - `success` true, required
  - `data` object[], required
    - `accountId` string, required
    - `bankId` string
    - `securityName` string
    - `securityId` string
    - `ticker` string
    - `quantity` number, required
    - `costBasis` number, nullable
    - `currentValue` number
    - `currentPrice` number
    - `currency` string, required
    - `isCashEquivalent` boolean

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/banksync/apis/banksync-api.md) · [All operations](https://skmtc.dev/banksync/apis/banksync-api/llms.txt) · [OpenAPI document](https://skmtc.dev/banksync/apis/banksync-api/revisions/94465f5ee922?raw)