---
title: "Query Sub-account List (For Master Account)"
method: GET
path: "/sapi/v1/sub-account/list"
tags: ["Sub-Account"]
---

# Query Sub-account List (For Master Account)

`GET /sapi/v1/sub-account/list`

Weight(IP): 1

## Query parameters

- `email` string
- `isFreeze` 'true' | 'false'
- `page` integer
- `limit` integer
- `recvWindow` integer
- `timestamp` integer, required
- `signature` string, required

## Response `200`

List of sub-accounts

- object
  - `subAccounts` object[], required
    - `email` string, required
    - `isFreeze` boolean, required
    - `createTime` integer, required
    - `isManagedSubAccount` boolean, required
    - `isAssetManagementSubAccount` boolean, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized Request

## Changes

- **2022-03-04** `f1d8926e955a` — 2 info
  - added the required property `subAccounts/items/isAssetManagementSubAccount` to the response with the `200` status
  - added the required property `subAccounts/items/isManagedSubAccount` to the response with the `200` status
- **2021-10-25** `a484ce871a72` — 4 breaking, 8 info
  - for the `query` request parameter `limit`, the type/format was changed from `integer`/`` to `integer`/`int32`
  - for the `query` request parameter `page`, the type/format was changed from `integer`/`` to `integer`/`int32`
  - for the `query` request parameter `recvWindow`, the type/format was changed from `integer`/`` to `integer`/`int64`
  - for the `query` request parameter `timestamp`, the type/format was changed from `integer`/`` to `integer`/`int64`
  - …8 more

[Change history](https://skmtc.dev/binance/apis/binance-public-spot-api/changes/sapi/v1/sub-account/list/get.md)

---

[API](https://skmtc.dev/binance/apis/binance-public-spot-api.md) · [All operations](https://skmtc.dev/binance/apis/binance-public-spot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/binance/binance-public-spot-api/revisions/0dd2f133e12d/schema)