Identities
A signer identity is a named human, registered once and reused across every artefact they review.
POST/v1/identities
Body: subject (stable id from your auth provider), tier (0 email, 1 sso, 2 org_attested, 3 kyc), displayName?, and orgDomain? (required at tier 2). Returns the identity with its uid.
GET/v1/identities/{uid}
Public. Returns subject, tier, display name, org domain, and verification time.
Tiers are load-bearing
An attestation may never claim a tier stronger than its identity supports; the verifier enforces this. The org-attested (green) tier is the workhorse for enterprises — see Identity tiers for how it’s established via domain verification and reviewer invites.