Uniqueness

One face = one identity — matches the captured face against the Valyd face registry for sybil and duplicate-account detection, as part of the Unique Human API.

🔑 Auth: App API key + a workflow with the face-uniqueness check · 👤 User account: none · 💾 Result: returned to your system; the face maps to a stable valyd_uuid

How it works

You create a session for a workflow containing the face-uniqueness check and redirect the person to Valyd’s verification page. The page captures a live burst, enrolls or matches the face against the registry, and the decision returns a stable valyd_uuid plus whether it was newly registered. The same face resolves to the same uuid on every run, so you can detect a person opening a second account. The biometric is stored as an irreversible vector encrypted with Valyd — never as an image — and is never exposed through any API.

Run it

import { VerifyClient } from "@valyd/sdk";
const verify = new VerifyClient({ apiKey: process.env.VALYD_API_KEY });
 
const session = await verify.sessions.create({
  workflowId:  process.env.VALYD_WORKFLOW_ID,  // a workflow with the face-uniqueness check
  redirectUrl: "https://yourapp.com/checked",
  vendorData:  "user-123",
});
// → redirect the person's browser to session.url

Pair it with Liveness in the same workflow so only a proven-live face is matched against the registry.

Result

const decision = await verify.sessions.decision(session.sessionId);
// decision.status: "APPROVED" | "DECLINED" | "IN_REVIEW"
 
// the face_uniqueness check's data:
// { valyd_uuid: "valyd_8f2…", registered: "existing" }
// registered: "new" the first time a face is seen, "existing" afterwards

Store the valyd_uuid against your own user record. A later session that resolves to an already seen uuid is the same human — your policy decides what happens next.

Deleting a face (GDPR)

To unlink a face your project no longer needs (right to erasure), remove it from the unique-face registry by its valyd_ uuid from the project’s Verification settings in the Developer Portal . The face is unlinked from your project, and fully deleted once no remaining project — and no Valyd account — still knows it.

Next

• Liveness — the anti-spoof half of the Unique Human API.
• Uniqueness bound to a connected user’s account runs inside a Reusable Verification workflow — see the checks reference.