---
title: "GET /v1/me/identity/verification"
method: GET
path: "/v1/me/identity/verification"
tags: ["IdentityService"]
---

# GET /v1/me/identity/verification

`GET /v1/me/identity/verification`

GetVerification 查询当前实名状态；网页方式自动查询，扫码方式仅在显式刷新时查询外部结果。
 扫码方式在单据过期前查询到未通过时仍保持 processing，并继续返回 certifyUrl 供用户再次扫码。

## Query parameters

- `refreshProvider` boolean

## Response `200`

OK

- IdentityV1GetVerificationReply — GetVerificationReply 当前实名状态。
  - `verification` IdentityV1IdentityVerification — IdentityVerification 是用户侧可见的实名状态，敏感字段仅返回脱敏值。
    - `certifyId` string — 支付宝核身/核验审计标识；人脸 processing 或二要素 verified 时可能返回。
    - `certifyUrl` string — 支付宝人脸核身 URL；仅异步 processing 时返回，二要素不返回。
    - `documentNoMasked` string
    - `documentType` string
    - `expiresAt` string, date-time — 当前核身单据过期时间。
    - `failReason` string — 最近一次失败原因。
    - `idCardMasked` string — 历史身份证脱敏字段；新客户端使用 documentNoMasked。
    - `realNameMasked` string — 脱敏姓名。
    - `remainingAttemptsToday` integer — 当前认证方式剩余提交次数；窗口由服务端策略决定。
    - `status` string — 状态：unverified / processing / verified。
    - `verifiedAt` string, date-time — 认证通过时间。
    - `verifyMethod` string — 本次认证方式。

---

[API](https://skmtc.dev/apiqik/apis/apiqik-api.md) · [All operations](https://skmtc.dev/apiqik/apis/apiqik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apiqik/apiqik-api/revisions/e06b96127408/schema)