Skip to main content

Install

npm install @verify-group/sdk
# or
pnpm add @verify-group/sdk

Initialize

import { VerifyGroupClient } from "@verify-group/sdk";

const vg = new VerifyGroupClient({
  baseUrl: "https://gateway.verify-group.io/api/v1",
  accessToken: process.env.VG_ACCESS_TOKEN,
  organizationId: process.env.VG_ORG_ID,
});

KYC

const kyc = await vg.kyc.create({
  participant_id: "uuid",
  type: "individual",
  scenario: "identity",
  payload: { identifier_type: "national_id", identifier_number: "12345678", country: "KE" },
});
await vg.kyc.sync(kyc.data.id);

Claims

const claim = await vg.claims.create({ type: "MOTOR", policyNumber: "POL-MT-KE-2025-8847", incidentDate: "2026-06-15", claimAmount: 185000 });
await vg.claims.updateStatus(claim.data.id, { status: "INVESTIGATING" });

Participants & sanctions

const p = await vg.participants.create({ firstName: "James", lastName: "Kamau", type: "individual", nationalId: "12345678", phone: "+254722000001", country: "KE" });
await vg.participants.createSanctionsCheck({ participantId: p.data.id, enableMonitoring: true });

Evidence

await vg.evidence.setTags(evidenceId, ["police_report", "verified"]);
await vg.evidence.review(evidenceId, { status: "APPROVED", notes: "Authentic." });

Voice analysis

await vg.voice.commands.analyzeCallRecording({ sessionId: "uuid", forceReanalysis: false });
const session = await vg.voice.queries.getCallRecordingSession("uuid");
console.log(session.data.analysisResults.keyScores);