@vouch-in/node

Official Vouch SDK for Node.js - Server-side email validation with higher rate limits.

Installation

npm install @vouch-in/node
# or
yarn add @vouch-in/node
# or
pnpm add @vouch-in/node

Quick Start

import { Vouch } from "@vouch-in/node";

// Initialize with your server API key
const vouch = new Vouch(
  process.env.VOUCH_PROJECT_ID,
  process.env.VOUCH_SERVER_KEY,
);

// Validate an email
const result = await vouch.validate("[email protected]", {
  ip: req.ip,
  userAgent: req.headers["user-agent"],
});

if (result.recommendation === "allow") {
  // Create user account
  console.log("Email is valid!");
} else {
  console.log("Validation failed:", result.recommendation);
}

Express.js Example

import express from "express";
import { Vouch } from "@vouch-in/node";

const app = express();
const vouch = new Vouch(PROJECT_ID, SERVER_KEY);

app.post("/api/signup", async (req, res) => {
  const { email } = req.body;

  const result = await vouch.validate(email, {
    ip: req.ip,
    userAgent: req.get("user-agent"),
  });

  if (result.recommendation !== "allow") {
    return res.status(400).json({ error: "Email validation failed" });
  }

  // Create user...
  res.json({ success: true });
});

Features

• Higher rate limits (5,000/hour vs 1,000/hour for client)
• No domain restrictions
• IP and User-Agent override
• Works with Express, Fastify, Koa, etc.
• Serverless compatible (AWS Lambda, Vercel, Cloudflare Workers)

Server vs Client Keys

| Feature | Client Key | Server Key | | ------------------- | ------------ | ------------ | | Domain Restrictions | Yes | No | | Rate Limits | 1,000/hour | 5,000/hour | | Override IP/UA | No | Yes | | Use Case | Browser apps | Backend APIs |

Documentation

For complete documentation, examples, and API reference, visit:

docs.vouch.expert/sdks/node

Related Packages

• @vouch-in/js - Browser SDK
• @vouch-in/next - Next.js integration
• @vouch-in/remix - Remix integration

License

Proprietary. Copyright (c) Vouch. All rights reserved.

See the SDK License Agreement for terms.