Skip to main content
POST
/
api
/
v3
/
verifications
/
biometrics-detection
Biometrics Detection
curl --request POST \
  --url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/biometrics-detection \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
  "trustFlowId": 0,
  "trustValidationId": "{your_trust_validation_id}"
}
'
{
  "success": true,
  "message": "Biometrics detection processed successfully",
  "data": {
    "enroll": {
      "companyId": 4,
      "enrolledAt": "2026-05-28T20:41:29.029854+08:00",
      "imageType": 0,
      "name": null,
      "recordId": 1,
      "referenceId": "455bc762-7b72-490f-8d6d-65ed0d9317f0",
      "status": 1,
      "watchlistId": 0
    },
    "screen": {
      "checkedWatchlists": [
        0
      ],
      "imageType": 0,
      "status": 1,
      "watchlists": [
        {
          "hasMatches": true,
          "matches": [
            {
              "enrolledAt": "2026-05-28T20:38:23.845620+08:00",
              "imageType": 0,
              "name": null,
              "recordId": 1,
              "referenceId": "455bc762-7b72-490f-8d6d-65ed0d9317f0",
              "similarityScore": 99
            }
          ],
          "watchlistId": 0
        }
      ]
    }
  },
  "verificationStatus": "REVIEW_NEEDED",
  "verificationStatusCode": 2,
  "trustFlowId": 0,
  "trustValidationId": "{your_trust_validation_id}",
  "verificationType": "biometrics_registration",
  "metadata": null
}

Authorizations

Authorization
string
header
required

Use Bearer {your_api_token} in the Authorization header.

Headers

Accept
string
default:application/json
Content-Type
string
default:application/json

Body

application/json
image
string
required

Face image as a base64 data URI (for example, data:image/jpeg;base64,...).

username
string
required

Username or display name associated with the registered biometric.

trustFlowId
integer
required

Trust flow identifier used to categorize or group requests for tracking or reporting.

trustValidationId
string
required

Trust validation identifier for the verification request.

Response

200 - application/json

Biometrics detection completed successfully

status
boolean
message
string
result
object
apiRequest
object