Verify a professional license
Professional-license verification is not its own public API — it is a workflow check in
Reusable Verification. The licensed professional
connects with Valyd, you open a verification session with their
valyd_access_token via the SDK, and the verified license badge saves to their Valyd ID
(reusable, no re-check next time). The name is taken from their verified account, so a holder
can’t be checked against someone else’s license.
import { VerifyClient } from "@valyd/sdk";
const verify = new VerifyClient({ apiKey: process.env.VALYD_API_KEY! });
// The professional has connected with Valyd — open a license session on their token.
const session = await verify.sessions.create({
workflowId: process.env.VALYD_LICENSE_WORKFLOW_ID!, // "License Verification"
valydAccessToken: user.valydAccessToken,
redirectUrl: `${process.env.APP_URL}/verify/callback`,
});
// Send the user to session.url — Valyd's verification page hosts the capture.
// Then read the authoritative result:
const decision = await verify.sessions.decision(session.sessionId);
// decision.checks → the "credential" check carries the license status- How to run it: Reusable Verification · Run a verification
- Which checks & availability: Checks reference
- Compose the workflow: in the Developer Portal → Workflows.
Last updated on