Skip to main content
Mass Duplicate Detection Enrollment mass-enrolls face images into the reserved biometric duplicate-detection watchlist. Enrollment is asynchronous: you submit a batch, get back an uploadId, then poll for the result. Base path: /api/v3/duplicate-detection
Scope is limited to your authenticated company. Uploads and polling results apply to the duplicate-detection enrollment for your company.

​
Authentication

Use the same authentication as all other v3 endpoints:
  • Bearer token (Sanctum) in the Authorization header
  • HMAC signature headers
See Introduction to the API for how to create an API token.

​
Endpoints

​
Upload status values

Poll the upload status endpoint until status is 2, 3, or 4. For high-volume mass-enrollment runs (for example, 300k selfies):
1

Chunk images into batches of 50

Split your image set into batches of up to 50 files per request.
2

Upload each batch

For each batch, call POST /api/v3/duplicate-detection/faces and store the returned uploadId.
3

Poll each upload

Poll GET /api/v3/duplicate-detection/uploads/{uploadId} until status is 2, 3, or 4.
For request/response details, see: