GetVisualValidateResult

{
  "BytedToken": "2026102008000076196B0812040B53D1B8"
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "GroupId": "group-20261020080200-fghij"
  }
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "GroupId": ""
  }
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1",
    "Error": {
      "Code": "NotFound",
      "Message": "The verification result is not available yet."
    }
  }
}

{
  "BytedToken": "2026102008000076196B0812040B53D1B8"
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "GroupId": "group-20261020080200-fghij"
  }
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "GroupId": ""
  }
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1",
    "Error": {
      "Code": "NotFound",
      "Message": "The verification result is not available yet."
    }
  }
}

POST {BaseUrl}/?Action=GetVisualValidateResult&Version=2024-01-01
Content-Type: application/json

Requests must be signed with HMAC-SHA256. See Authentication and conventions.

Outcome	Response
Verification not finished yet	HTTP 404 with `Code` `NotFound`. Query again later
Verification succeeded	HTTP 200 with the real-person group ID in `Result.GroupId`
Verification failed, timed out or the session expired	HTTP 200 with an empty `Result.GroupId`. Create a new session

Query every 3–5 seconds until HTTP 200 is returned.

Request parameters

string

required

Session token returned by CreateVisualValidateSession.

string

Pass default or omit.

Response parameters

string

ID of the real-person asset group created on success (GroupType is LivenessFace). Empty string if verification did not succeed.

{
  "BytedToken": "2026102008000076196B0812040B53D1B8"
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "GroupId": "group-20261020080200-fghij"
  }
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "GroupId": ""
  }
}

{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1",
    "Error": {
      "Code": "NotFound",
      "Message": "The verification result is not available yet."
    }
  }
}

Interface Guide

API Endpoints

Usage Examples

Request parameters

Response parameters

​Request parameters

​Response parameters

Request parameters

Response parameters