Verify group — SenseCrypt eID Docs

This endpoint performs N:N face search and verification against a group image. It detects all faces in the supplied image and attempts to match each detected face against every SensePrint in the provided list, decrypting the metadata for any matches found.

Use this endpoint to:

Verify the presence of known individuals in a group photo or video frame
Perform batch identity lookups against a roster of SensePrints in a single request

Up to 15 SensePrints can be supplied per request.

Endpoint POST /verify-group

Request Parameters:

Prop

Type

Each entry in requests will have a senseprint encoded as base64 and password/veriiers_auth_key if set for the senseprint.

Example Request

{
  "group_image_base_64": "group_image_base_64",
  "is_group_image": true,
  "requests": [
    {
      "senseprint_base_64": "<base64 string>",
      "password": "optional_password",
      "verifiers_auth_key": "optional_auth_key"
    },
    {
      "senseprint_base_64": "<another_base64_string>",
      "password": null,
      "verifiers_auth_key": null
    }
  ]
}

Example Response

{
    "decrypted_data": [
      {
        "record_id": "R2",
        "metadata": {
          "name": "Shristi",
          "address": "Mumbai, India"
        },
        "cleartext_data": {
          "masked_id": "A2"
        },
        "extra_binary_data_base64": "",
        "face_crop_base_64": "iVBORw0KGgoAAAANSUhEUgAAAVAAAAFKCAYAAABLpQckAAAMPmlDQ...",
        "difficulty": "REGULAR"
      }
    ],
    "unmatched_face_crops": [
      "iVBORw0KGgoAAAANSUhEUgAAAVAAAAFKCAYAAABLpQckAAAMPmlDQ...",
      "iVBORw0KGgoAAAANSUhEUgAAAVAAAAFKCAYAAABLpQckAAAMPmlDQ..."
    ]
  }