> For the complete documentation index, see [llms.txt](https://docs.vida.id/identity-stack/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vida.id/identity-stack/verify/liveness/integration/api/api-reference/liveness-transaction-details-api/id-fraud-shield-enabled.md).

# ID Fraud Shield Enabled

This is Liveness Transaction Details API when ID Fraud Shield is **enabled**. In this configuration, the API returns both the VIDA Liveness detection result and the ID Fraud Shield analysis result.

The ID Fraud Shield analysis provides an additional fraud risk assessment based on the captured identity verification data. Depending on the configured risk threshold, the ID Fraud Shield result may influence the final liveness transaction outcome.

To retrieve the transaction details, partners must provide the transaction ID obtained from the Liveness API response or the SDK liveness output.

## Liveness API

<mark style="color:green;">`GET`</mark> `https://{vida.host}/biometrics/v2/services/face/liveliness?transactionId={UUID}`

#### Headers

<table><thead><tr><th width="190.46875">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>Authorization<mark style="color:red;">*</mark></td><td></td><td><p>OAuth access token. </p><p>Get the token by calling the</p><p><strong>Authentication</strong> API</p></td></tr></tbody></table>

## API Response

### Liveness Passed + ID Fraud Shield Passed

{% hint style="info" %}
Liveness transaction completed successfully with **scores below threshold.**

ID Fraud Shield transaction completed successfully with **scores below threshold.**
{% endhint %}

HTTP Status: `200`

<details>

<summary>JSON Response</summary>

```json
{
    "data": {
        "transaction": {
            "transactionId": "unique transaction id generated to identify this transaction",
            "transactionCode": 1041
        },
        "scores": [
            {
                "scoreName": "LIVENESS",
                "scoreValue": 0.910008
            },
            {
                "scoreName": "IMAGE_MANIPULATION",
                "scoreValue": 0.910211
            }
        ],
        "image": "Base64 image",
        "fraudAnalysis": {
        ...
        // Detail information will be shared by VIDA team
        }
```

</details>

### Liveness Passed + ID Fraud Shield Threshold Exceeded

{% hint style="info" %}
Liveness transaction completed successfully with **scores below threshold.**

ID Fraud Shield transaction completed successfully with **scores exceeded threshold.**
{% endhint %}

HTTP Status: `200`

<details>

<summary>JSON Response</summary>

```json
{
    "data": {
        "transaction": {
            "transactionId": "unique transaction id generated to identify this transaction",
            "transactionCode": 10001
        },
        "errors": [
            {
                "code": 1705,
                "title": "Fraud shield risk level exceeded error threshold",
                "detail": "Fraud shield risk level exceeded error threshold"
            }
        ],
        "image": "Base64 image",
        "fraudAnalysis": {
        ...
        // Detail information will be shared by VIDA team
        }
```

</details>

### Liveness Threshold Exceeded + ID Fraud Shield Passed

{% hint style="info" %}
Liveness transaction completed successfully with **scores above threshold.**

ID Fraud Shield transaction completed successfully with **scores below threshold.**
{% endhint %}

HTTP Status: `200`

<details>

<summary>JSON Response</summary>

```json
{
    "data": {
        "transaction": {
            "transactionId": "unique transaction id generated to identify this transaction",
            "transactionCode": 1041
        },
        "scores": [
            {
                "scoreName": "LIVENESS",
                "scoreValue": 0.999674
            },
            {
                "scoreName": "IMAGE_MANIPULATION",
                "scoreValue": 0.971477
            }
        ],
        "image": "Base64 image",
        "fraudAnalysis": {
        ...
        // Detail information will be shared by VIDA team
        }
```

</details>

### Liveness Threshold Exceeded + ID Fraud Shield Threshold Exceeded

{% hint style="info" %}
Liveness transaction completed successfully with **scores above threshold.**

ID Fraud Shield transaction completed successfully with **scores exceeded threshold.**
{% endhint %}

HTTP Status: `200`

<details>

<summary>JSON Response</summary>

```json
{
    "data": {
        "transaction": {
            "transactionId": "unique transaction id generated to identify this transaction",
            "transactionCode": 10001
        },
        "errors": [
            {
                "code": 1705,
                "title": "Fraud shield risk level exceeded error threshold",
                "detail": "Fraud shield risk level exceeded error threshold"
            }
        ],
        "image": "Base64 image",
        "fraudAnalysis": {
        ...
        // Detail information will be shared by VIDA team
        }
        
```

</details>

### Liveness Failed + ID Fraud Shield Passed

{% hint style="info" %}
Liveness transaction **failed due to particular reason.**

ID Fraud Shield transaction completed successfully with **scores below threshold.**
{% endhint %}

HTTP Status: `200`

<details>

<summary>JSON Response</summary>

```json
{
    "data": {
        "transaction": {
            "transactionId": "unique transaction id generated to identify this transaction",
            "transactionCode": 10001
        },
        "errors": [
            {
                "code": 1063,
                "title": "Image Quality Is Below Threshold",
                "detail": "Unnatural colour"
            },
            {
                "code": 1075,
                "title": "Image Quality Is Below Threshold",
                "detail": "Over Exposure"
            },
            {
                "code": 1076,
                "title": "Image Quality Is Below Threshold",
                "detail": "Image Is Blur"
            },
	     {
                "code": 1705,
                "title": "Fraud shield risk level exceeded error threshold",
                "detail": "Fraud shield risk level exceeded error threshold"
            }
        ],
        "image": "Base64 image",
        "fraudResult": {
        ...
        // Detail information will be shared by VIDA team
        }
```

</details>

### Liveness Failed + ID Fraud Shield Threshold Exceeded

{% hint style="info" %}
Liveness transaction **failed due to particular reason.**

ID Fraud Shield transaction completed successfully with **scores exceeded threshold.**
{% endhint %}

HTTP Status: `200`

<details>

<summary>JSON Response</summary>

```json
{
    "data": {
        "transaction": {
            "transactionId": "unique transaction id generated to identify this transaction",
            "transactionCode": 10001
        },
        "errors": [
            {
                "code": 1063,
                "title": "Image Quality Is Below Threshold",
                "detail": "Unnatural colour"
            },
            {
                "code": 1075,
                "title": "Image Quality Is Below Threshold",
                "detail": "Over Exposure"
            },
            {
                "code": 1076,
                "title": "Image Quality Is Below Threshold",
                "detail": "Image Is Blur"
            },
	         {
                "code": 1706,
                "title": "Fraud shield risk transaction detail not found",
                "detail": "Fraud shield risk level transaction detail not found"
            }	
        ],
        "image": "Base64 image",
        "fraudAnalysis": {
        ...
        // Detail information will be shared by VIDA team
        }
```

</details>