> ## Documentation Index
> Fetch the complete documentation index at: https://docs-vip.apigo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GetVisualValidateResult

> Get the liveness verification result and the ID of the real-person asset group it created.

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

Requests must be signed with HMAC-SHA256. See [Authentication and conventions](https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/asset-overview.md#authentication).

| 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

**BytedToken** `string` *required*

Session token returned by [CreateVisualValidateSession](https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/create-visual-validate-session.md).

**ProjectName** `string`

Pass `default` or omit.

## Response parameters

**Result.GroupId** `string`

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

```json Request body theme={null}
{
  "BytedToken": "2026102008000076196B0812040B53D1B8"
}
```

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

```json Not succeeded theme={null}
{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "GroupId": ""
  }
}
```

```json Not finished theme={null}
{
  "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."
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.