VerifEye Face API Release Notes

Version History

Release Date: 2026-09-10

Image URLs behind a CDN or a bot filter now download: the fetch of your image.url identifies itself with a User-Agent. Hosts that refuse a request without one - a common CDN and bot-filter default - answered 403 or 406, and the call came back saying the image could not be downloaded, for an image that opens in your own browser. If you worked around that by re-hosting such images, you no longer need to.

Release Date: 2026-08-06

Initial Release: First public release of the VerifEye Face API — the single entry point for face onboarding, identification and analysis.
Onboard (POST /v1/face/onboard): looks every face on the image up in the collection and adds the ones that are not already there.
Identify (POST /v1/face/identify): looks every face on the image up in the collection and never adds anything.
Compare (POST /v1/face/compare): the 1:1 check. Scores the faces on an image against one face already in the collection, named by its faceId, and answers similarity and isMatch for each. The collection is never searched and never written to. Use it when you already know who the person claims to be; use Identify when you do not.
Optional attributes: request the age, gender, emotions and attention of every face alongside its face id through the include object, in the same call.
Multiple faces per call: maxFaces answers about up to 4 faces on one image; every face left out is counted in unprocessedFaceCount.
Collection management: create, retrieve, update, reset and delete collections.
External keys: associate your own identifier with a face and look faces up by it (set, get-face-ids, delete).

The VerifEye Face API supersedes the Face Recognition, Face Verification, Demographic Estimation and Emotion & Attention APIs for new integrations. Those APIs continue to work unchanged until September 30, 2026, after which they will be retired.

For the latest updates, visit the VerifEye Developer Console