Identity

Verify, prove, and credential a human

Identity is one resource. KYC, biometric verification, professional licenses, and zero-knowledge attribute proofs all live on the Identity object.

Overview

You typically interact with Identity in three ways:

• Retrieve the current state of a person you've already onboarded.
• Verify a person at the moment of action — get a signed proof you can store as audit evidence.
• Prove a specific attribute (age over 21, active license) without exposing the underlying data.

The Identity object

{
  "id": "person_8YQz2N3xK1pWvBtRf",
  "object": "person",
  "verified": true,
  "name": { "given": "Alex", "family": "Chen" },
  "face_match": { "score": 0.99, "liveness": "passed" },
  "licenses": [{
    "type": "nurse", "status": "active",
    "jurisdiction": "US-CA", "expires_at": "2027-06-30"
  }]
}

Verify a person at the moment of action

const proof = await valyd.identity.verify({
  person: "person_8YQz...",
  checks: ["face_match", "liveness", "license:nurse"],
  context: "telehealth_session_8YQz"
}, { idempotencyKey: "telehealth_session_8YQz_open" });

if (!proof.passed) throw new VerificationFailed(proof.failed_checks);

Credentials and licenses

Zero-knowledge proofs

Sometimes you don't need the data — you need the answer. ZK proofs let you ask "is this person 21?" and get a yes/no, signed and verifiable, without ever seeing the date of birth.

const proof = await valyd.identity.proofs.create({
  person: "person_8YQz...",
  claim: { type: "age_at_least", threshold: 21 }
});

Quick reference

Request API access →