Valido
Back to Home

API Documentation

Everything you need to integrate Valido's email validation API into your applications.

1. Get API Key
Sign up for a free account and get your API key from the dashboard.
2. Make Request
Send a POST request to our validation endpoint with your email data.
curl -X POST \
  https://api.valido.com/validate
3. Get Results
Receive detailed validation results with AI-powered risk scoring.
{
  "isValid": true,
  "riskScore": 25
}

API Reference

POST /api/validate
Single Validation
Validate a single email address and get detailed analysis.

Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request Body

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

Response

{
  "email": "user@example.com",
  "isValid": true,
  "riskScore": 25,
  "details": {
    "syntax": true,
    "domain": true,
    "disposable": false,
    "corporate": true,
    "ageEstimate": "2+ years",
    "providerType": "corporate",
    "spamTrap": false,
    "breachHistory": false
  }
}
POST /api/validate/bulk
Bulk Validation
Validate multiple email addresses in a single request.

Request Body

{
  "emails": [
    "user1@example.com",
    "user2@example.com",
    "user3@example.com"
  ]
}

Response

{
  "results": [
    {
      "email": "user1@example.com",
      "isValid": true,
      "riskScore": 25
    },
    {
      "email": "user2@example.com",
      "isValid": false,
      "riskScore": 85
    }
  ],
  "summary": {
    "total": 3,
    "valid": 2,
    "invalid": 1
  }
}

Response Fields

email
string
The email address that was validated
isValid
boolean
Whether the email address is valid
riskScore
number
Risk score from 0-100 (lower is better)
details.syntax
boolean
Whether the email has valid syntax
details.domain
boolean
Whether the domain exists
details.disposable
boolean
Whether it's a disposable email address
details.corporate
boolean
Whether it's a corporate email address
details.spamTrap
boolean
Whether it's a known spam trap

Error Codes

400
Bad Request
Invalid request format or missing required fields
401
Unauthorized
Invalid or missing API key
402
Payment Required
Insufficient credits or plan limits exceeded
429
Too Many Requests
Rate limit exceeded
500
Internal Server Error
Unexpected server error

SDKs & Libraries

JavaScript/Node.js
Official SDK for JavaScript and Node.js applications
npm install @valido/sdk
Python
Official Python SDK for easy integration
pip install valido-python
PHP
Official PHP SDK for web applications
composer require valido/php-sdk

Need Help?

Our support team is here to help you integrate Valido successfully.