---
title: "Query wealth service status"
method: GET
path: "/merchant/open/institution/v1/wealth/query"
---

# Query wealth service status

`GET /merchant/open/institution/v1/wealth/query`

Query the wealth management status of a sub-account. `X-GatePay-On-Behalf-Of` identifies the delegated institution account ID.

## Headers

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

## Response `200`

Success

- WealthQueryResponseWrapper
  - `status` string
  - `code` string
  - `errorMessage` string
  - `data` WealthQueryResponse
    - `account_id` string — Sub-account ID
    - `status` 'CANCEL' | 'SIGN' — Wealth status: CANCEL disabled; SIGN enabled
    - `enabled` integer — Enable time (milliseconds)
    - `updated` integer — Last update time (milliseconds)

---

[API](https://skmtc.net/gate/apis/gatepay-institutional-api.md) · [All operations](https://skmtc.net/gate/apis/gatepay-institutional-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gate/gatepay-institutional-api/versions/bb3314b74dc3/schema)