# Types for Face Liveness

Types used for validating face liveness on IDmission's servers.

## Scope and provenance

- Product: web
- Status: Imported reference snapshot. Import date is not a verification date or guarantee of current release support.
- SDK version: Not declared for this page. Versions in examples must not be assumed current.
- Environment: Page-specific. Confirm the environment host, credentials, and service configuration; do not infer them from another product.
- Source: https://websdk2docs.idmission.com/submission/face-liveness
- Imported at: 2026-10-21T17:27:01.149Z
- Canonical page: https://docs.idmission.com/web/submission/face-liveness
- Agent index: https://docs.idmission.com/llms.txt

---

<a id="liveness-check-requests"></a>

### Liveness Check Requests

```ts
type LivenessCheckRequest = {
  securityData: {
    userName: string
    password: string
    merchantId: number
  }
  customerData: {
    additionalData: {
      uniqueRequestId: string
    }
    biometricData: {
      selfie: string
    }
    idData: {
      idImageFront: string
    }
  }
  additionalData: {
    uniqueRequestId: string
    clientRequestID: string
    jobID: string
    sendDecisionDetailsInPost: "Y" | "N"
    stripSpecialCharacters: "Y" | "N"
    estimateAge: "Y" | "N"
    predictGender: "Y" | "N"
    metadata: string
  }
}
```

<a id="liveness-check-responses"></a>

### Liveness Check Responses

```ts
type LivenessCheckResponse = {
  status: {
    statusCode: string
    statusMessage: string
    errorData: string
  }
  resultData: {
    uniqueRequestId: string
    verificationResult: string
    verificationResultId: number
    verificationResultCode: string
    verificationResultDetails: {
      Decision_LiveCheck: {
        DecisionResult: string
        DecisionStateCode: string
      }
    }
    realScore: number
    eyeCovering: "true" | "false"
    eyeCoveringScore: number
    faceMask: "true" | "false"
    faceMaskScore: number
    headCovering: "true" | "false"
    headCoveringScore: number
    cellPhone: "true" | "false"
    cellPhoneScore: number
    estimatedAge: number
    livenessToken: string
  }
  additionalData: {
    liveFaceDetectionFlag: "true" | "false"
  }
}
```