Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1465453454.1 KB

Retrieves the results of a specific Face Liveness session. It requires the <code>sessionId</code> as input, which was created using <code>CreateFaceLivenessSession</code>. Returns the corresponding Face Liveness confidence score, a reference image that includes a face bounding box, and audit images that also contain face bounding boxes. The Face Liveness confidence score ranges from 0 to 100. The reference image can optionally be returned.

post/#X-Amz-Target=RekognitionService.GetFaceLivenessSessionResults

Headers

X-Amz-Target'RekognitionService.GetFaceLivenessSessionResults' required

Request body

SessionIdstring required

A unique 128-bit UUID. This is used to uniquely identify the session and also acts as an idempotency token for all operations associated with the session.

Response

Success

SessionIdstring required

The sessionId for which this request was called.

Status'CREATED' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' required

Represents a status corresponding to the state of the session. Possible statuses are: CREATED, IN_PROGRESS, SUCCEEDED, FAILED, EXPIRED.

Confidencenumber float

Probabalistic confidence score for if the person in the given video was live, represented as a float value between 0 to 100.