npm install @keverdjs/agent

const keverdPromise = import(
  'https://cdn.keverd.com/v1/YOUR_PUBLIC_API_KEY/keverd.min.js'
).then((Keverd) => Keverd.start());

keverdPromise
  .then((k) => k.getVisitorData())
  .then((r) => {
    console.log(r.requestId); // billable event id — send to your server
    console.log(r.visitorId);  // persistent device id
  });

<script type="module">
  const keverd = await import(
    'https://cdn.keverd.com/v1/kv_pk_live_…/keverd.min.js'
  ).then((m) => m.start());

  const result = await keverd.getVisitorData();
  await fetch('/api/keverd/verify', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ eventId: result.requestId || result.event_id }),
  });
</script>

import { Keverd } from '@keverdjs/agent';

Keverd.init('kv_pk_live_…');
// or
Keverd.init({
  apiKey: 'kv_pk_test_…',
  endpoint: 'https://api.keverd.com',
});

const result = await Keverd.getVisitorData();

console.log(result.event_id);     // send to your server
console.log(result.requestId);    // same billable id (CDN-friendly alias)
console.log(result.fingerprint);  // persistent device id
console.log(result.visitorId);    // alias of fingerprint
console.log(result.action);       // allow | soft_challenge | hard_challenge | block
console.log(result.risk_score);

{
  "fingerprint": "kvd_…",
  "visitorId": "kvd_…",
  "event_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "requestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "session_id": "…",
  "risk_score": 12,
  "score": 0.12,
  "action": "allow",
  "reason": [],
  "similarity": 0.98,
  "is_new": false,
  "times_seen": 3,
  "first_seen": "2026-07-01T09:00:00.000000",
  "last_seen": "2026-07-25T12:00:00.000000"
}

{
  "eventId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

await Keverd.verifyLogin({ /* … */ });
await Keverd.verifyCheckout(amount, currency);
await Keverd.verifyRegistration();
await Keverd.verifyPasswordReset();
await Keverd.verifyAccountChange();