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

# List subaccounts

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

## Request

- Base URL: `https://api.anchorage-staging.com/v2`
- URL: `https://api.anchorage-staging.com/v2/subaccounts/customers/{customerId}/accounts`
- Auth: API key in header `Api-Access-Key`
- TypeScript: <https://skmtc.dev/anchorage/apis/anchorage-digital-api-reference/docs/subaccounts/customers/:customerId/accounts/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/anchorage/apis/anchorage-digital-api-reference.md) - [All operations](https://skmtc.dev/anchorage/apis/anchorage-digital-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/anchorage/apis/anchorage-digital-api-reference/revisions/166864b1ec6d?raw)