Amazon Rekognition

Amazon Rekognition Face Liveness API

Verify that a user is physically present during identity verification.

Documentation GitHub OpenAPI

Operations 2

POST /#CreateFaceLivenessSession Amazon Rekognition Create Face Liveness Session #

POST /#GetFaceLivenessSessionResults Amazon Rekognition Get Face Liveness Session Results #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/amazon-rekognition-face-liveness-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Amazon Rekognition Celebrity Recognition Face Liveness API
  description: Amazon Rekognition is a cloud-based computer vision service providing image and video analysis including label detection, facial analysis, face comparison, celebrity recognition, text detection, content moderation, custom labels, face liveness detection, and streaming video analysis.
  version: '2016-06-27'
  contact:
    name: AWS Support
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  x-generated-from: documentation
servers:
- url: https://rekognition.amazonaws.com
  description: Amazon Rekognition global endpoint
tags:
- name: Face Liveness
  description: Verify that a user is physically present during identity verification.
paths:
  /#CreateFaceLivenessSession:
    post:
      operationId: createFaceLivenessSession
      summary: Amazon Rekognition Create Face Liveness Session
      description: Initiates a Face Liveness session and returns a SessionId for streaming.
      tags:
      - Face Liveness
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/CreateFaceLivenessSessionRequest'
            examples:
              createFaceLivenessSessionRequestExample:
                summary: Default createFaceLivenessSession request
                x-microcks-default: true
                value:
                  ClientRequestToken: token-abc123
      responses:
        '200':
          description: Face liveness session created.
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/CreateFaceLivenessSessionResponse'
              examples:
                createFaceLivenessSession200Example:
                  summary: Default createFaceLivenessSession 200 response
                  x-microcks-default: true
                  value:
                    SessionId: 550e8400-e29b-41d4-a716-446655440000
        '400':
          description: Invalid request.
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - aws_signature: []
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /#GetFaceLivenessSessionResults:
    post:
      operationId: getFaceLivenessSessionResults
      summary: Amazon Rekognition Get Face Liveness Session Results
      description: Retrieves the results of a specific Face Liveness session.
      tags:
      - Face Liveness
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/GetFaceLivenessSessionResultsRequest'
            examples:
              getFaceLivenessSessionResultsRequestExample:
                summary: Default getFaceLivenessSessionResults request
                x-microcks-default: true
                value:
                  SessionId: 550e8400-e29b-41d4-a716-446655440000
      responses:
        '200':
          description: Face liveness session results retrieved.
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/GetFaceLivenessSessionResultsResponse'
              examples:
                getFaceLivenessSessionResults200Example:
                  summary: Default getFaceLivenessSessionResults 200 response
                  x-microcks-default: true
                  value:
                    SessionId: 550e8400-e29b-41d4-a716-446655440000
                    Status: SUCCEEDED
                    Confidence: 98.5
        '400':
          description: Invalid request.
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - aws_signature: []
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    GetFaceLivenessSessionResultsResponse:
      type: object
      properties:
        SessionId:
          type: string
          format: uuid
        Status:
          type: string
          enum:
          - CREATED
          - IN_PROGRESS
          - SUCCEEDED
          - FAILED
          - EXPIRED
        Confidence:
          type: number
          format: float
          description: Confidence value between 0 and 100 of live presence.
          example: 98.5
        ReferenceImage:
          type: object
        AuditImages:
          type: array
          items:
            type: object
    GetFaceLivenessSessionResultsRequest:
      type: object
      required:
      - SessionId
      properties:
        SessionId:
          type: string
          format: uuid
          description: The sessionId for the Face Liveness session.
    CreateFaceLivenessSessionResponse:
      type: object
      properties:
        SessionId:
          type: string
          description: A unique 128-bit UUID identifying a Face Liveness session.
          format: uuid
          example: 550e8400-e29b-41d4-a716-446655440000
    ErrorResponse:
      type: object
      description: Standard error response from the Amazon Rekognition API.
      properties:
        __type:
          type: string
          description: The type of exception.
          example: InvalidParameterException
        message:
          type: string
          description: Human-readable description of the error.
          example: Request has invalid parameters.
    CreateFaceLivenessSessionRequest:
      type: object
      properties:
        KmsKeyId:
          type: string
        Settings:
          type: object
        ClientRequestToken:
          type: string
  securitySchemes:
    aws_signature:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4. Include the Authorization header with AWS4-HMAC-SHA256 signature.