Node.js SDK

npm install @proofage/node

PROOFAGE_API_KEY=pk_live_...
PROOFAGE_SECRET_KEY=sk_live_...

import { ProofAgeClient } from '@proofage/node';

const client = new ProofAgeClient(); // keys from the environment
// or: new ProofAgeClient({ apiKey: 'pk_live_...', secretKey: 'sk_live_...' });

npx @proofage/node verify-setup

const verification = await client.verifications().create({
  external_id: 'user_12345',
  callback_url: 'https://yourapp.example/verified',
  external_metadata: { plan: 'pro' },
});

// send the person to verification.url

const v = client.verifications('550e8400-e29b-41d4-a716-446655440000');

const verification = await v.get();      // status, reason, duplicate_check, …
const document = await v.document();     // document fields and media
const estimation = await v.estimation(); // minimum-age result

for (const media of document?.media ?? []) {
  if (media.url === null) continue;      // deleted by retention or erasure
  await v.downloadMediaTo(media.id, `./${media.type}.jpg`);
}

import { webhookHandler } from '@proofage/node';

// Next.js App Router, Hono, Cloudflare Workers, …
export const POST = webhookHandler(async (payload) => {
  // payload.verification_id, payload.status, payload.reason
});