Find Template

The identity verification API allows you to perform identity verification using a selfie image and a photo from the database.

Endpoint

POST https://cloud.ooto-ai.com/api/v1.0/identify

Parameters

  • photo: (Photo) The selfie image file.

Authentication

To access the API, you need to include the following headers in your request:

  • APP-ID: Your application's unique identifier.

  • APP-KEY: Your application's authentication key.

Example

curl -X POST --location 'https://cloud.ooto-ai.com/api/v1.0/identify' \
--header 'APP-ID: <put_app_id_here>' \
--header 'APP-KEY: <put_app_key_here>' \
--form 'photo=@"/path/to/photo"'

Replace «put_app_id_here», «put_app_key_here» with your actual credentials and the path to your selfie image.

Response (HTTP 200)

{
    "transactionId": "ce394cea-a3cf-4044-8ce8-54e398dda667",
    "result": {
        "templateId": "e85098dd-4667-4a91-a0a0-adf5b8e9336d",
        "similarity": 1,
        "face": {
            "box": {
                "x": 25,
                "y": 275,
                "w": 606,
                "h": 761
            },
            "landmarks": [
                [
                    230,
                    574
                ],
                [
                    457,
                    567
                ],
                [
                    369,
                    740
                ],
                [
                    248,
                    802
                ],
                [
                    444,
                    796
                ]
            ],
            "liveness": {
                "score": 0.8860905766487122,
                "fine": true
            },
            "quality": {
                "uniformity": {
                    "value": 0.7044515103338633,
                    "fine": true
                },
                "exposure": {
                    "value": 0.5734725113730128,
                    "fine": true
                },
                "contrast": {
                    "value": 0.5869247898479624,
                    "fine": true
                },
                "flare": {
                    "score": 0.997887909412384,
                    "fine": false
                },
                "blur": {
                    "score": 0.0012071678647771478,
                    "fine": true
                },
                "occlusion": {
                    "score": 0.8302246928215027,
                    "fine": false
                },
                "macroblocks": {
                    "score": 0.0000013804340142087312,
                    "fine": true
                },
                "emotion": {
                    "score": 0.0040520974434912205,
                    "fine": true
                },
                "right_eye_closed": {
                    "score": 0.9050158113241196,
                    "fine": false
                },
                "left_eye_closed": {
                    "score": 0.0009260773658752441,
                    "fine": true
                },
                "crfiqa": {
                    "score": 0.5428674221038818,
                    "fine": false
                },
                "distortion": {
                    "score": 0.3051091432571411,
                    "fine": true
                },
                "gender": "male",
                "age": 62,
                "race": "white",
                "pitch": 17.443319857120514,
                "yaw": 10.05310446023941,
                "roll": 1.412617564201355
            }
        }
    }
}

Last updated