Find User Id by Face

This method is used to find if there's a single Biometrid Id that match the face sent on the request.

Find-by-Face

POST Https://api.biometrid.com/api/1.0/users/find-by-face

Find Biometrid Id by face.

Headers

Name
Type
Description

Content-type

string

Request content type (This is not required to be set. Referenced only to show how we expect data to be sent). { "Content-Type": "multipart/form-data" }

x-biometrid-key

string

Application Client Key

x-biometrid-secret

string

Application Client Secret

Request Body

Name
Type
Description

liveness

boolean

Optional liveness state flag. For now, just implemented on the biometrid SDK.

photo

object

Image file containing user's face for biometric analysis. File format: jpeg, png or jpg. Maximum file size 1 Mb.

HTTP/1.1 200 OK
// Find Id by Face
    {
      "status": true,
      "data": {
        "message": "FACE_RECOGNIZED_WITH_SUCCESS"
        "verified": true,
        "userId": '5be3000bd3adgd3e152724f2',
        "confidence": '0.78'
      }
  }
// Find Id by Face failed.
  {
      "status": false,
      "data": {
          "message": "FACE_ENROLLMENT_FAILED",
          "reason": "No faces found on 'photo'"
        }
  }
Example (JSON)
{
    "photo": face.jpeg
    "liveness": true
}

Success 200

Field

Type

Description

status

Boolean

Response status.

data

Object

Response main data.

message

String

Message regarding process status.

verified

Boolean

If present, indicates the status for the verification process.

userId

String

Biometrid Id return by the process if face match an already enrolled user.

confidence

String

Confidence returned by the engine regarding the face verification. (between 0-1)

Last updated

Was this helpful?