---
title: "GET /detectLivenessWithVerify/singleModal/sessions/{sessionId}"
method: GET
path: "/detectLivenessWithVerify/singleModal/sessions/{sessionId}"
---

# GET /detectLivenessWithVerify/singleModal/sessions/{sessionId}

`GET /detectLivenessWithVerify/singleModal/sessions/{sessionId}`

Get session result of detectLivenessWithVerify/singleModal call.

## Path parameters

- `sessionId` string, required

## Response `200`

The request has succeeded.

- LivenessWithVerifySession — Session result of detect liveness with verify.
  - `id` string, required — The unique ID to reference this session.
  - `createdDateTime` string, date-time, required — DateTime when this session was created.
  - `sessionStartDateTime` string, date-time — DateTime when this session was started by the client.
  - `sessionExpired` boolean, required — Whether or not the session is expired.
  - `deviceCorrelationId` string — Unique Guid per each end-user device. This is to provide rate limiting and anti-hammering. If 'deviceCorrelationIdSetInClient' is true in this request, this 'deviceCorrelationId' must be null.
  - `authTokenTimeToLiveInSeconds` integer — Seconds the session should last for. Range is 60 to 86400 seconds. Default value is 600.
  - `status` 'NotStarted' | 'Started' | 'ResultAvailable', required — The current status of the session.
  - `result` LivenessSessionAuditEntry — Audit entry for a request in session.
    - `id` integer, required — The unique id to refer to this audit request. Use this id with the 'start' query parameter to continue on to the next page of audit results.
    - `sessionId` string, required — The unique sessionId of the created session. It will expire 48 hours after it was created or may be deleted sooner using the corresponding session DELETE operation.
    - `requestId` string, required — The unique requestId that is returned by the service to the client in the 'apim-request-id' header.
    - `clientRequestId` string, required — The unique clientRequestId that is sent by the client in the 'client-request-id' header.
    - `receivedDateTime` string, date-time, required — The UTC DateTime that the request was received.
    - `request` AuditRequestInfo, required — Audit entry for a request in the session.
      - `url` string, required — The relative URL and query of the liveness request.
      - `method` string, required — The HTTP method of the request (i.e., GET, POST, DELETE).
      - `contentLength` integer — The length of the request body in bytes.
      - `contentType` string, required — The content type of the request.
      - `userAgent` string — The user agent used to submit the request.
    - `response` AuditLivenessResponseInfo, required — Audit entry for a response in the session.
      - `body` LivenessResponseBody, required — The response body of detect liveness API call.
        - `livenessDecision` 'uncertain' | 'realface' | 'spoofface' — The outcome of the liveness classification.
        - `target` LivenessOutputsTarget — The liveness classification for target face.
          - `faceRectangle` FaceRectangle, required — A rectangle within which a face can be found.
            - `top` integer, required — The distance from the top edge if the image to the top edge of the rectangle, in pixels.
            - `left` integer, required — The distance from the left edge if the image to the left edge of the rectangle, in pixels.
            - `width` integer, required — The width of the rectangle, in pixels.
            - `height` integer, required — The height of the rectangle, in pixels.
          - `fileName` string, required — The file name which contains the face rectangle where the liveness classification was made on.
          - `timeOffsetWithinFile` integer, required — The time offset within the file of the frame which contains the face rectangle where the liveness classification was made on.
          - `imageType` 'Color' | 'Infrared' | 'Depth', required — The type of image.
        - `modelVersionUsed` '2022-10-15-preview.04' | '2023-12-20-preview.06' — The model version used for liveness classification.
        - `verifyResult` LivenessWithVerifyOutputs — The face verification output.
          - `verifyImage` LivenessWithVerifyImage, required — The detail of face for verification.
            - `faceRectangle` FaceRectangle, required — A rectangle within which a face can be found.
              - …
            - `qualityForRecognition` 'low' | 'medium' | 'high', required — Indicates quality of image for recognition.
          - `matchConfidence` number, float, required — The target face liveness face and comparison image face verification confidence.
          - `isIdentical` boolean, required — Whether the target liveness face and comparison image face match.
      - `statusCode` integer, required — The HTTP status code returned to the client.
      - `latencyInMilliseconds` integer, required — The server measured latency for this request in milliseconds.
    - `digest` string, required — The server calculated digest for this request. If the client reported digest differs from the server calculated digest, then the message integrity between the client and service has been compromised and the result should not be trusted. For more information, see how to guides on how to leverage this value to secure your end-to-end solution.
    - `sessionImageId` string — The image ID of the session request.
    - `verifyImageHash` string — The sha256 hash of the verify-image in the request.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** `44e2cf82becd` — 1 info
  - endpoint added
- **2026-07-13** `e1f63ec9983b` — 1 info
  - endpoint added
- **2026-07-13** `5375faa8d134` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/ai-face/changes/detectLivenessWithVerify/singleModal/sessions/:sessionId/get.md)

---

[API](https://skmtc.dev/azure/apis/ai-face.md) · [All operations](https://skmtc.dev/azure/apis/ai-face/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/ai-face/revisions/44e2cf82becd/schema)