Email verification API for developers

import express from 'express';
import { verifyWebhookSignature } from '@rocketverifier/sdk';

app.post('/webhooks/rocketverifier', express.raw({ type: 'application/json' }), (req, res) => {
  const ok = verifyWebhookSignature(
    req.body,
    req.get('X-RocketVerifier-Signature'),
    process.env.RV_WEBHOOK_SECRET,
  );
  if (!ok) return res.sendStatus(400);

  const event = JSON.parse(req.body);
  // de-duplicate on event.event_id, then handle event.event
  res.sendStatus(200);
});

import os
from flask import Flask, request, abort
from rocketverifier import verify_webhook_signature

app = Flask(__name__)

@app.post("/webhooks/rocketverifier")
def rocketverifier_webhook():
    if not verify_webhook_signature(
        request.get_data(),
        request.headers.get("X-RocketVerifier-Signature"),
        os.environ["RV_WEBHOOK_SECRET"],
    ):
        abort(400)
    event = request.get_json()
    # de-duplicate on event["event_id"], then handle event["event"]
    return "", 200

{
  "event_id": "6f1c2a8e-5d4b-4f7a-9c3e-2b1a0d9e8f7c",
  "event": "job.completed",
  "timestamp": "2026-10-15T12:04:31+00:00",
  "data": {
    "job_id": "kZ3vQ9xLp2Rm8TnW4yBc1A",
    "status": "completed",
    "name": "October leads",
    "total_emails": 10000,
    "processed_emails": 10000,
    "valid_count": 8512,
    "invalid_count": 1187,
    "risky_count": 151,
    "catch_all_count": 98,
    "disposable_count": 52,
    "created_at": "2026-10-15T11:58:02+00:00",
    "completed_at": "2026-10-15T12:04:31+00:00",
    "download_url": "https://api.rocketverifier.com/v1/jobs/kZ3vQ9xLp2Rm8TnW4yBc1A/download"
  }
}