---
agentTools:
  projectIndex: https://scandoc.readme.io/llms.txt
---

# /recognition/stateless/

This endpoint is used for comparing two face images without storing any data, it is convenient when comparing a document and a live face image

This endpoint is used to compare two faces and discern their similarity. If the faces are deemed similar enough, those can be considered the same. Primary function was designed in comparing a face from the document image and a live image of a face.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Guest Identification API",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.scandoc.ai/cis/"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/recognition/stateless/": {
      "post": {
        "summary": "/recognition/stateless/",
        "description": "This endpoint is used for comparing two face images without storing any data, it is convenient when comparing a document and a live face image",
        "operationId": "recognitionstateless",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "description": "Access token retrieved from key service",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "AcceptTermsAndConditions",
                  "DataFields"
                ],
                "properties": {
                  "AcceptTermsAndConditions": {
                    "type": "boolean",
                    "description": "Terms and conditions must be accepted or the request will be rejected",
                    "default": true
                  },
                  "DataFields": {
                    "type": "object",
                    "description": "Object containing images",
                    "required": [
                      "DocumentFaceImageType",
                      "DocumentFaceImage",
                      "LiveFaceImageType",
                      "LiveFaceImage"
                    ],
                    "properties": {
                      "DocumentFaceImageType": {
                        "type": "string",
                        "description": "Parameter describing face image encoding (currently only base64 is allowed)",
                        "default": "base64"
                      },
                      "DocumentFaceImage": {
                        "type": "string",
                        "description": "Face image retrieved from the document (or other source) that is supposed to get compared to live face image"
                      },
                      "LiveFaceImageType": {
                        "type": "string",
                        "description": "Parameter describing live image encoding (currently only base64 is allowed)",
                        "default": "base64"
                      },
                      "LiveFaceImage": {
                        "type": "string",
                        "description": "Face image retrieved from a selfie snapshot (or some other source) that is supposed to get compared to document image"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Successful recognition": {
                    "value": "{\n  \"TransactionID\": \"<transaction-uuid>\",\n  \"UploadedAt\": \"<timestamp>\",\n  \"ProductName\": \"Guest Identification v<Service-version>\",\n  \"Errors\": [\"<Error1>\", ...],\n  \"Warnings\": [\"<Warning1>\", ...],\n  \"Status\": 200,\n  \"Method\": \"StatelessRecognition\",\n  \"UserId\": <user-id>,\n  \"SubClientId\": <sub-user-id>,\n  \"Data\": {\n    \"Verified\": true,\n    \"Similarity\": 0.96\n  }\n}"
                  },
                  "Unsuccessful recognition": {
                    "value": "{\n  \"TransactionID\": \"<transaction-uuid>\",\n  \"UploadedAt\": \"<timestamp>\",\n  \"ProductName\": \"Guest Identification v<Service-version>\",\n  \"Errors\": [\"<Error1>\", ...],\n  \"Warnings\": [\"<Warning1>\", ...],\n  \"Status\": 200,\n  \"Method\": \"StatelessRecognition\",\n  \"UserId\": <user-id>,\n  \"SubClientId\": <sub-user-id>,\n  \"Data\": {\n    \"Verified\": false,\n    \"Similarity\": 0.33\n  }\n}"
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "6511de94eb250f00120ab66a:6511e1759b2f4500502dada6"
}
```