---
title: "Sub-account Transfer History (For Sub-account)"
method: GET
path: "/sapi/v1/sub-account/transfer/subUserHistory"
tags: ["Sub-Account"]
---

# Sub-account Transfer History (For Sub-account)

`GET /sapi/v1/sub-account/transfer/subUserHistory`

- If `type` is not sent, the records of type 2: transfer out will be returned by default.
- If `startTime` and `endTime` are not sent, the recent 30-day data will be returned.

Weight(IP): 1

## Query parameters

- `asset` string
- `type` integer
- `startTime` integer
- `endTime` integer
- `limit` integer
- `recvWindow` integer
- `timestamp` integer, required
- `signature` string, required

## Response `200`

Transfer id

- object[]
  - `counterParty` string, required
  - `email` string, required
  - `type` integer, required — 1 for transfer in, 2 for transfer out
  - `asset` string, required
  - `qty` string, required
  - `fromAccountType` string, required
  - `toAccountType` string, required
  - `status` string, required
  - `tranId` integer, required
  - `time` integer, required

## Other responses

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

## Changes

- **2023-09-19** `558ab69ec555` — 2 breaking
  - removed the enum value `1.00` from the `query` request parameter `type`
  - removed the enum value `2.00` from the `query` request parameter `type`
- **2021-10-25** `a484ce871a72` — 6 breaking, 14 info
  - for the `query` request parameter `endTime`, the format changed from no format to `int64`
  - for the `query` request parameter `limit`, the format changed from no format to `int32`
  - for the `query` request parameter `recvWindow`, the format changed from no format to `int64`
  - for the `query` request parameter `startTime`, the format changed from no format to `int64`
  - …16 more

[Change history](https://skmtc.dev/binance/apis/binance-public-spot-api/changes/sapi/v1/sub-account/transfer/subUserHistory/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)