The graph
Node names are the model names used in consent grants (models).
GET /v1/graph/models lists the same models — for example ConsumerIdentity,
with the resource path consumer-identities — together with every field.
How to read the graph
consumer_identityis the entity itself. Its SSN and date of birth together are the match key that lets contributions from different participants attach to one person.- Identity records — email, phone, address, identity document — are attached to the person, and some carry their own verification events (a phone number’s verification, an address’s capture and verification).
- Verification events are furnished outcomes. The KYC events — document, biometric, liveness, address, and identity corroboration — are what a KYC certificate query consolidates into up to nine sub-products. Income, employment, and fraud verification are separate models that can also be furnished.
- Screening events —
bad_actor_eventandfinancial_crimes_watch_event— back the screening list products. consumer_consent_eventis not data about the consumer so much as the permission record that governs querying them.
Each branch carries provenance
A verification event becomes a reusable trust asset because its lineage travels with it. Furnished events record the participant that furnished them, and can link to that participant’s attestation. Certificate sub-products surface this asfurnishing_entity_id and attestation_event_id, plus an assertions block
recording what was asserted and when. Some records also carry a reference to
the evidence behind them, such as an identity document’s upload. See
Provenance for the full lineage model.
What you can actually read back is decided by the network’s
querying policy and by
entitlement. The graph describes what
can exist; consent, policy, and entitlement decide what you see.
Trust assets for a consumer
Consolidated through products, the consumer graph yields assets such as:- Verified identity — a KYC certificate consolidating document, biometric, liveness, address, and corroboration evidence.
- Verified address — address capture and verification outcomes.
- Screening — screening list results drawn from furnished bad-actor and financial-crimes watch events.
Related
Business graph
The equivalent for businesses.
KYC Certificate
The consolidated identity trust asset, field by field.
Trust assets
What makes a verification reusable.
Provenance
The lineage each branch carries.