---
title: "List of Sub-Accounts (Large Accounts)"
method: GET
path: "/portfolio/subaccounts2"
tags: ["Account", "Portfolio"]
---

# List of Sub-Accounts (Large Accounts)

`GET /portfolio/subaccounts2`

Used in tiered account structures (such as Financial Advisor and IBroker Accounts) to return a list of sub-accounts, paginated up to 20 accounts per page, for which the user can view position and account-related information. This endpoint must be called prior to calling other /portfolio endpoints for those sub-accounts. If you have less than 100 sub-accounts use /portfolio/subaccounts. To query a list of accounts the user can trade, see /iserver/accounts.

## Path parameters

- `page` string, required

## Response `200`

An object containing an array

- object
  - `metadata` object
    - `total` number — Number of sub-accounts
    - `pageSize` number — How many sub-accounts are returned for the page requested. A max of 20 per page.
    - `pageNume` number — Current page number.
  - `subaccounts` object[]
    - `id` string — The account identification value
    - `accountId` string — The account number
    - `accountVan` string — The accountAlias
    - `accountTitle` string — Title of the account
    - `displayName` 'accountTitle' | 'accountVan' | 'accountId' — Whichever value is not null in this priority
    - `accountAlias` string — User customizable account alias. Refer to [Configure Account Alias](https://guides.interactivebrokers.com/cp/cp.htm#am/settings/accountalias.htm) for details.
    - `accountStatus` number — When the account was opened in unix time.
    - `currency` 'AUD' | 'GBP' | 'CAD' | 'CNH' | 'CZK' | 'DKK' | 'EUR' | 'HKD' | 'HUF' | 'INR' | 'ILS' | 'JPY' | 'MXN' | 'NOK' | 'NZD' | 'PLN' | 'RUB' | 'SGD' | 'SEK' | 'CHF' | 'USD' — Base currency of the account.
    - `type` 'INDIVIDUAL' | 'JOINT' | 'ORG' | 'TRUST' | 'DEMO' — Account Type
    - `tradingType` string — UNI - Deprecated property
    - `faclient` boolean — If an account is a sub-account to a Financial Advisor.
    - `clearingStatus` 'O' | 'P' | 'N' | 'A' | 'R' | 'C' — Status of the Account * O = Open * P or N = Pending * A = Abandoned * R = Rejected * C = Closed covestor: type: boolean description: Is a Covestor Account parent: type: object properties: mmc: type: array items: type: string description: Money Manager Client (MMC) Account accountId: type: string description: Account Number for Money Manager Client isMParent: type: boolean description: Is MM a Parent Account isMChild: type: boolean description: Is MM a Child Account isMultiplex: type: boolean description: Is a Multiplex Account. These are account models with individual account being parent and managed account being child. desc: type: string description: Formatted "accountId - accountAlias"

---

[API](https://skmtc.dev/interactivebrokers/apis/client-portal-web-api.md) · [All operations](https://skmtc.dev/interactivebrokers/apis/client-portal-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interactivebrokers/client-portal-web-api/revisions/32edbfe496d1/schema)