Verify a credential in your app

​

What you’ll build

1. A verification program configured for your app.
2. SDK code that prompts the user to present a credential.
3. Application logic that reacts to the verification result.

​

Prerequisites

• AIR Kit SDK installed and initialized. See Installation and Initialization.
• A Verifier DID from the Developer Dashboard.
• At least one credential issued to a test user (see Issue Credentials Quickstart).

​

Step 1: Create a verification program

1. Go to the Developer Dashboard.
2. Navigate to Verifier > Programs.
3. Create a new verification program, selecting the credential schema you want to verify against.
4. Note the Verification Program ID.

​

Step 2: Authenticate the user

const airService = new AirService();
await airService.init({ partnerId: "your-partner-id" });
const loginResult = await airService.login();

​

Step 3: Request credential verification

const verificationResult = await airService.verifyCredentials({
  verifierDid: "did:air:id:test:YOUR_VERIFIER_DID",
  verificationId: "YOUR_VERIFICATION_PROGRAM_ID",
});

if (verificationResult.verified) {
  console.log("Credential verified:", verificationResult);
  grantAccess();
} else {
  console.log("Verification failed or was declined");
  denyAccess();
}

final result = await airService.verifyCredentials(
  verifierDid: "did:air:id:test:YOUR_VERIFIER_DID",
  verificationId: "YOUR_VERIFICATION_PROGRAM_ID",
);

if (result.verified) {
  grantAccess();
} else {
  denyAccess();
}

​

Step 4: Gate features based on the result

function grantAccess() {
  // User has a valid credential — show premium content, unlock tier benefits, etc.
}

function denyAccess() {
  // No valid credential — redirect to onboarding or show a restricted view
}

​

Auth token for server-side verification

const payload = {
  partnerId: "your-partner-id",
  scope: "verify",
  exp: Math.floor(Date.now() / 1000) + 5 * 60,
};

​

Next steps

• Credential Verification reference for the full API
• Schema Design to understand what fields are verifiable
• Quickstart: Credential Verification for a step-by-step walkthrough