---
title: "List Sub-Accounts"
method: GET
path: "/merchant/open/institution/v1/accounts/list"
---

# List Sub-Accounts

`GET /merchant/open/institution/v1/accounts/list`

## Request

- Base URL: `https://openplatform.gateapi.io`
- URL: `https://openplatform.gateapi.io/merchant/open/institution/v1/accounts/list`
- Auth: none declared. Required headers: `X-GatePay-Certificate-ClientId`, `X-GatePay-Timestamp`, `X-GatePay-Nonce`, `X-GatePay-Signature`

Paginated list of sub-accounts.

## Query parameters

- `status` 'ACTIVE'
- `request_id` string
- `customer_id` string
- `created_gte` integer
- `created_lte` integer
- `limit` integer
- `cursor` integer

## Headers

- `X-GatePay-Certificate-ClientId` string, required
- `X-GatePay-Timestamp` string, required
- `X-GatePay-Nonce` string, required
- `X-GatePay-Signature` string, required

## Response `200`

Success

- ListSubAccountsResponseWrapper
  - `status` string
  - `code` string
  - `errorMessage` string
  - `data` ListSubAccountsResponse
    - `accounts` AccountInfo[]: List of sub-accounts.
      - `request_id` string: Creation request ID.
      - `account_id` string: Sub-account ID.
      - `customer_id` string: Customer ID on the platform side.
      - `display_name` string: Display name.
      - `status` 'INIT' | 'PENDING' | 'ACTIVE' | 'FAIL' | 'RISK_SUSPEND' | 'NONE': Account status: initial - INIT, processing - PENDING, created - ACTIVE, creation failed - FAIL, risk control suspended - RISK_SUSPEND, not enabled - NONE.
      - `created` integer: Creation time (milliseconds).
    - `has_more` boolean: Whether there are more pages.

## Changes

- **2026-09-04** `62d31c7e909a`: 6 warning
  - added the new `ACTIVE` enum value to the `data/accounts/items/status` response property for the response status `200`
  - added the new `FAIL` enum value to the `data/accounts/items/status` response property for the response status `200`
  - added the new `INIT` enum value to the `data/accounts/items/status` response property for the response status `200`
  - added the new `NONE` enum value to the `data/accounts/items/status` response property for the response status `200`
  - …2 more

[Operation history](https://skmtc.dev/gate/apis/gatepay-institutional-api/changes/merchant/open/institution/v1/accounts/list/get.md)

---

[API](https://skmtc.dev/gate/apis/gatepay-institutional-api.md) - [All operations](https://skmtc.dev/gate/apis/gatepay-institutional-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gate/apis/gatepay-institutional-api/revisions/4627cdb35251?raw)