Create a Person

Create a Person

POST - https://api.verifik.co/v2/face-recognition/persons

The Create Person API allows you to create a new person within the facial recognition system. You can associate a person with their name, images, gender, date of birth, nationality, collections, and additional notes.

Implementation

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

{
  "name": "Mateo Verifik",
  "collection_id": "dac2c81b-12bv-4f19-a6b0-d1a72d55b64b",
  "notes": "Verifik employee",
  "date_of_birth": "1995-05-07",
  "nationality": "Colombian",
  "gender": "M",
  "images": [
    "Base 64 Images"
  ]
}

Response

200

{
    "data": {
        "thumbnails": [
            {
                "id": "cfe0e19a-cb26-4e55-aa28-44761324f66b",
                "thumbnail": "Base 64 Image"
            }
        ],
        "gender": "M",
        "date_of_birth": "1995-05-07",
        "nationality": "Colombian",
        "collections": [
            "0dc5245b-cee53-4dce-aba8-9174c12fdfb2"
        ],
        "notes": "Verifik employee",
        "documentValidations": [],
        "_id": "65807837049c624ea360c092",
        "deleted": false,
        "name": "Mateo Verifik",
        "client": "64404b1f9856cc8cebd762e7",
        "updatedAt": "2024-01-10T21:55:03.645Z",
        "createdAt": "2024-01-10T21:55:03.645Z",
        "__v": 0
    }
}

400

{
  "error": "Invalid request"
}

Create Persons | Live

POST - https://api.verifik.co/v2/face-recognition/persons

Comprehensive service for the proper creation of persons within a collection, ensuring optimal management of individuals through the following workflow:

• It first conducts a search in the collection 1:N to ensure that no duplicate person is generated within the same collection.

• If no match is found between the FaceMap and a FaceHash stored in the collection, it proceeds to perform a Liveness Detection on the FaceMap image.

• Once the above steps are completed, the service accurately generates a new person within the collection. Verifik ensures that no persons with the same face are generated and additionally verifies that they are real and alive.

NOTE: The "images" parameter is an array in which up to 3 images of the same person can be sent. If they are not of the same person, the system will not create the user correctly.

Implementation

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

{
  "name": "Mateo Verifik",
  "collection_id": "dac2c81b-12bv-4f19-a6b0-d1a72d55b64b",
  "notes": "Verifik employee",
  "date_of_birth": "1995-05-07",
  "nationality": "Colombian",
  "gender": "M",
  "images": [
    "Base 64 Images"
  ],
  "min_score": 0.7,
  "search_mode": "FAST",
  "liveness_min_score": 0.5
}

Response

200

{
    "data": {
        "thumbnails": [
            {
                "id": "cfe0e19a-cb26-4e55-aa28-44761324f66b",
                "thumbnail": "Base 64 Image"
            }
        ],
        "gender": "M",
        "date_of_birth": "1995-05-07",
        "nationality": "Colombian",
        "collections": [
            "0dc5245b-cee53-4dce-aba8-9174c12fdfb2"
        ],
        "notes": "Verifik employee",
        "documentValidations": [],
        "_id": "65807837049c624ea360c092",
        "deleted": false,
        "name": "Mateo Verifik",
        "client": "64404b1f9856cc8cebd762e7",
        "updatedAt": "2024-01-10T21:55:03.645Z",
        "createdAt": "2024-01-10T21:55:03.645Z",
        "__v": 0
    }
}

400

{
  "error": "Invalid request"
}