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

# Query Verification Status

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

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`

---

[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-service-production.skmtc.workers.dev/v1/apis/gate/gatepay-institutional-api/revisions/b83b60d86dc6/schema)