---
title: "List subaccounts"
method: GET
path: "/subaccounts/customers/{customerId}/accounts"
tags: ["Subaccounts"]
---

# List subaccounts

`GET /subaccounts/customers/{customerId}/accounts`

Permissions required: **Subaccount** or **Read Subaccount**

Return all subaccounts associated to a customerId

## Path parameters

- `customerId` string, required

## Query parameters

- `endDate` string, date
- `afterId` string
- `statuses` string[]
- `limit` integer

## Response `200`

Successfully returned subaccounts

- SubaccountsResponse
  - `data` SubaccountsDetails[], required
    - `accruedFees` AccruedFeeType[], required
      - `accruedValue` string, required — Accrued fee value for the period.
      - `endPeriod` string, date, required — The end date (inclusive) in `YYYY-MM-DD` format of the period accrued. Dates are always in UTC [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) 'full-date'.
      - `rate` number, required — The rate should be in percentage format. The rate should be a value between 0 and 1 where 0.01 is 1%.
      - `startPeriod` string, date, required — The start date (inclusive) in `YYYY-MM-DD` format of the period accrued. Dates are always in UTC [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) 'full-date'.
      - `state` 'ONGOING' | 'DONE', required
      - `totalBalanceInUSD` string — Assets under custody value in USD at the time of accrual.
      - `type` 'ADVISORY' | 'MODEL' | 'MANAGEMENT' | 'CUSTODY', required
    - `balances` BalanceDetails[], required
      - `assetType` string — A string representing a type of crypto-asset, which usually corresponds to the crypto asset's ticker symbol. Use `/asset-types` to list all of the supported asset types for your organization.
      - `availableForTrading` string
      - `availableForWithdrawal` string
      - `entries` Balance[]
        - `amount` string
        - `description` string — A description of the balance type and its meaning
      - `totalBalance` string
    - `createdAt` string, date-time, required — The timestamp when the subaccount was created.
    - `customerId` string, required — Unique identifier for the customer DEPRECATED, please use `customers` field instead
    - `customers` SubaccountCustomer[] — List of account owners with their respective roles (can only be changed during onboarding)
      - `customerId` string — Unique Identifier for the program customer
      - `role` 'PRIMARY' | 'SECONDARY' — Role of the program customer in the subaccount
    - `externalSubaccountId` string, required — The external unique identifier used to identify this subaccount
    - `fees` FeeDetailType[], required
      - `isBillable` boolean, required — Defines if a fee will be billed directly to the subaccount.
      - `rate` number, required — The rate should be in percentage format. The rate should be a value between 0 and 1 where 0.01 is 1%.
      - `startDate` string, date, required — The start date (inclusive) in `YYYY-MM-DD` format. This date should always be set in the future. Dates are always in UTC [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) 'full-date'.
      - `type` 'ADVISORY' | 'MODEL' | 'MANAGEMENT' | 'CUSTODY', required
    - `name` string, required — The name of the subaccount
    - `status` 'OPEN' | 'CLOSED' | 'SUBMITTED' — Status of the subaccount
    - `subaccountId` string, required — Unique Identifier for the subaccount
    - `subType` 'ROLLOVER' | 'CONVERSION' — SubType of the subaccount, may not always apply
    - `type` 'IRA' | 'ROTH' | 'JOINT' | 'CUSTODIAL' | 'INDIVIDUAL_TAXABLE' | 'INSTITUTIONAL_TAXABLE' — Type of the subaccount
  - `page` Page — Pagination info
    - `next` string, nullable — URL to use to query for the next page or null if no additional results are available

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference.md) · [All operations](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anchorage/anchorage-digital-api-reference/versions/166864b1ec6d/schema)