Skip to Content
Docs

Read verified data

🔑 Auth: the user’s Bearer valyd_access_token · 💸 Free — reads never cost a check · 🔒 Proofs and public data only, never PII

Three reads cover everything the account already holds:

APIOne call gets you
GET /oidc/userinfoWho they are — legal name, username, country, id_verified
GET /oidc/licensesProfessional licenses already verified on their account
GET /oidc/verificationsEvery proof and badge — KYC done, age bands, license badges
const proofs = await valyd.auth.getVerifications(accessToken); if (proofs.id_verified) { // KYC already done — you're finished. No check, no cost, no PII stored. }

This is the KYC-reuse story: the user verified once — maybe in another app. You check the status, you don’t re-run it, and you never store personal data.

Raw identity attributes (DOB, document fields) are separate — the user approves them explicitly via the consent flow.

Reads are only half of it — with the same token you can re-prove who they are, right now: match their face before a sensitive action, confirm their location, or re-check a live license. See what the verification APIs let you build.

Something missing? Run a configured workflow on a Reusable Verification session with the user’s token — face match, liveness, license, age, location, and KYC are all available as workflow checks (see the checks reference). The user completes them on Valyd’s verification page, and the passed proofs save back to their Valyd ID.

Last updated on