API

Integrate verification into your workflow

Authenticate with an API key from your dashboard. All endpoints return JSON. Base URL: https://veritas.fugati.ai

Authentication

API key

Pass your API key in the Authorization header on every request.

Authorization: Bearer YOUR_API_KEY

Get your key from the dashboard. Rotate it anytime via POST /api/keys/rotate.

Endpoints

Reference

POST/api/verify/single

Verify a single email address. Returns status, confidence score, and cost.

Request body

{ "email": "user@example.com" }

Response

{
  "email": "user@example.com",
  "status": "valid",
  "confidence": 95,
  "cost": 0.005
}
POST/api/verify/batch

Upload a CSV or XLSX file for batch verification. Returns a job ID to poll.

Request body

FormData: file=<csv or xlsx>

Response

{ "jobId": "job_abc123", "emailCount": 2500 }
GET/api/verify/job/:id

Poll job status. Returns progress and download URLs when complete.

Response

{
  "jobId": "job_abc123",
  "status": "complete",
  "progress": 100,
  "downloads": {
    "csv": "https://...",
    "pdf": "https://...",
    "goldMine": "https://..."
  }
}
GET/api/credits

Check your current credit balance.

Response

{ "credits": 842.50 }
POST/api/credits/topup

Initiate a top-up via Stripe. Returns a Stripe checkout URL.

Request body

{ "amount": 50 }

Response

{ "checkoutUrl": "https://checkout.stripe.com/..." }
POST/api/keys/rotate

Rotate your API key. The old key is immediately invalidated.

Response

{ "apiKey": "vrt_new_key_..." }

Examples

Verify a single email

cURL

curl -X POST https://veritas.fugati.ai/api/verify/single \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'

Node.js

const res = await fetch("https://veritas.fugati.ai/api/verify/single", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ email: "user@example.com" }),
});
const data = await res.json();

Python

import requests

response = requests.post(
    "https://veritas.fugati.ai/api/verify/single",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"email": "user@example.com"},
)
data = response.json()

Rate limits

Limits

Single verification60 requests / minute
Batch upload10 jobs / hour
Job polling120 requests / minute
Max file size50MB
Max emails per batch500,000

Get your API key

Go to dashboard →