List Verification Sessions

GET /api/volc-user/visual-validate-sessions

List the current user's sessions from both creation modes, ordered by record ID descending.

Authentication

Use a logged-in session Cookie or the Authorization: <access_token> header. Obtain the access token through Generate Access Token. It is different from the sk- key used for model requests.

Request Parameters

Name	Type	Required	Description
pageNumber	integer	Optional	Page number, starting at 1; defaults to 1
pageSize	integer	Optional	Page size; defaults to 20 and resets to 20 when below 1 or above 100
status	string	Optional	Filter by Pending, Processing, Succeeded, Failed, or Expired; omit for all sessions

Request Example

GET /api/volc-user/visual-validate-sessions?pageNumber=1&pageSize=20&status=Succeeded
Authorization: <access_token>

Response Fields (200)

Name	Type	Description
success	boolean	Business success flag; check it even for HTTP 200
message	string	Message; empty on success
data	object	Response data on success
data.totalCount	integer	Total number of records
data.pageNumber	integer	Current page number
data.pageSize	integer	Page size
data.items	array<object>	Records on the current page
data.items[].sessionId	string	Platform session ID used to query the result
data.items[].status	string	Pending, Processing, Succeeded, Failed, or Expired; see Integration Guide
data.items[].h5Link	string	Returned only while Pending and unexpired; the person being verified must open it
data.items[].expiresAt	integer	Link expiry time in Unix seconds; sessions currently expire 120 seconds after creation
data.items[].groupId	string	Platform asset group ID after success; omitted when absent or, for queries, when the group has been deleted
data.items[].resultCode	string	H5 verification result code, if present; 10000 indicates verification success
data.items[].errorCode	string	Error code, if present
data.items[].errorMessage	string	Error message, if present
data.items[].createTime	integer	Creation time in Unix seconds
data.items[].updateTime	integer	Update time in Unix seconds

Response Example

{
  "success": true,
  "message": "",
  "data": {
    "totalCount": 1,
    "pageNumber": 1,
    "pageSize": 20,
    "items": [
      {
        "sessionId": "vvs-example",
        "status": "Succeeded",
        "expiresAt": 1792022520,
        "createTime": 1792022400,
        "updateTime": 1792022430,
        "groupId": "group-example",
        "resultCode": "10000"
      }
    ]
  }
}

The session ID field is always sessionId in this list. Deleted groups are no longer returned through groupId, while verification history is retained.