---
title: "Query Verification Status"
method: GET
path: "/cashier/open/v1/certification/verify/query"
tags: ["Institutional"]
---

# Query Verification Status

`GET /cashier/open/v1/certification/verify/query`

## Request

- Base URL: `https://openplatform.gateapi.io`
- URL: `https://openplatform.gateapi.io/cashier/open/v1/certification/verify/query`
- Auth: none declared. Required headers: `X-GatePay-Certificate-ClientId`, `X-GatePay-Timestamp`, `X-GatePay-Nonce`, `X-GatePay-Signature`

Query the current KYB verification status of an institutional sub-account.

## Query parameters

- `subAccountId` integer, required

## 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

- QueryVerifyResponseWrapper: Query verification status response
  - `code` string: Response code
  - `message` string: Response message
  - `data` GatePayVerifyQueryData: Verification status query result
    - `merchantNo` string: Institution main merchant ID
    - `subAccountId` string: Institutional sub-account ID
    - `currentAuthStatus` 'un_open' | 'submitted' | 'succeeded' | 'rejected': Latest overall verification status of the sub-account
    - `accountType` 'KYB': Verification type; always KYB
    - `submitTime` integer: Submission time (milliseconds)
    - `auditTime` integer: Audit completion time (milliseconds); returned only when status is `succeeded` or `rejected`
    - `rejectReason` string: Rejection reason; returned only when status is `rejected`

## Changes

- **2026-10-12** `4627cdb35251`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gate/apis/gatepay-institutional-api/changes/cashier/open/v1/certification/verify/query/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)