Sign Up

Getting Started

Learn how to get started with Veille's email and IP validation services

Veille helps you identify and block fake email addresses and malicious IPs, so you can focus on real users and maintain a clean, engaged user base while protecting your applications from abuse.

A note from the founder

Building enterprise SaaS infrastructure, I've witnessed the evolution of sophisticated threat vectors firsthand. Our API-first security stack neutralizes fraudulent signups and intercepts distributed proxy attacks that routinely bypass conventional verification systems.

Veille empowers engineering teams to focus on core product development with zero security compromises. Our real-time validation engines deliver deterministic threat detection with low latency through proprietary heuristic algorithms and continuous threat intelligence.

— Josselin Liebe, Founder & CEO

Key features

FeatureDescriptionBenefit
Disposable email detectionBlock temporary emails with our constantly updated databasePrevent low-quality signups
MX record validationVerify domain validity with proper mail server checksAvoid invalid email domains
Public domain detectionIdentify free email providers like Gmail and YahooDifferentiate between personal and professional emails
Smart email suggestionsCatch and correct common typos automaticallyImprove user experience and data quality
Domain blocklist managementMaintain your custom blocklist of problematic domainsControl exactly what domains you want to block
IP intelligenceDetect proxy, VPN, and malicious IPsProtect against fraud and abuse
Custom security rulesCreate and apply rules based on IP, email, and user agent patternsImplement sophisticated security policies
Multi-factor validationCheck email, domain, and IP in a single API callStreamlined integration with comprehensive security

API Overview

Veille offers several API endpoints to validate different aspects of user data:

EndpointPurposeDocumentation
/api/v1/blocklist🚫 Manage your domain blocklistBlocklist API
/api/v1/rule🛡️ Manage custom security rulesRules API
/api/v1/validate🔍 Check multiple factors in one requestValidation API
/api/v1/email/{email}✉️ Validate a single email addressEmail API
/api/v1/domain/{domain}🌐 Check domain validity and statusDomain API
/api/v1/ip/{ip}🖥️ Analyze IP address reputation and detailsIP API

Getting Started

  1. Sign Up: Create your account at Veille (no credit card required)
  2. Get Your API Key: Find it in your account dashboard under Settings → API Keys
  3. Make Your First Request: Start validating emails or IPs immediately

Authentication

All API requests require your API key in the x-api-key header or as a query parameter:

x-api-key: your-api-key-here

or

https://veille.io/api/v1/{path}?x_api_key=your-api-key-here

Your first API request

Let's validate an email address as your first API request:

GET https://veille.io/api/v1/email/fw-8ore64zd@yopmail.net

Response

{
  "email": "fw-8ore64zd@yopmail.net",
  "allowed": false,
  "reason": "disposable_domain",
  "provider": "yopmail"
}

You can also check a domain's status with:

GET https://veille.io/api/v1/domain/yopmail.net

Or validate an IP address:

GET https://veille.io/api/v1/ip/192.168.1.1

Multi-factor Validation

For comprehensive security, use our validation endpoint to check multiple factors at once:

POST https://veille.io/api/v1/validate

{
  "email": "user@example.com",
  "ip": "203.55.255.204", // abusive ip
  "user_agent": "Mozilla/5.0 (platform; rv:gecko-version) Gecko/gecko-trail Firefox/firefox-version"
}

(it's a wrong user agent)

Response

{
  "allowed": false,
  "ip": "203.55.255.204",
  "email": "user@example.com",
  "user_agent": "Mozilla/5.0 (platform; rv:gecko-version) Gecko-gecko-trail Firefox/firefox-version",
  "reason": "rule_triggered",
  "matched_rules": [
      {
          "rule_id": "block_abuser",
          "name": "block_abuser",
          "action": "block"
      },
      {
          "rule_id": "block_ua",
          "name": "Block UA",
          "action": "block"
      }
  ]
}

Next Steps