Documentation

API Documentation

Everything you need to integrate ValidoAPI. Clean endpoints, predictable JSON, and examples for every major language.

Quick Start

Get your API key and make your first validation request in under 5 minutes.

Authentication

Learn how to authenticate API requests using Bearer token authorization.

Email Validate Endpoint

POST /v1/email/validate — full request/response reference with all parameters.

Bulk Verification

POST /v1/email/bulk — upload CSV, poll job status, download results.

SDKs & Libraries

Official SDKs for Node.js, Python, PHP, and JavaScript. Community SDKs too.

Error Reference

Complete list of error codes, HTTP status codes, and how to handle them.

API Endpoints

MethodPathDescription

POST/v1/email/validateValidate a single email address

POST/v1/email/bulkSubmit bulk email validation job

GET/v1/email/bulk/{id}Check bulk job status

GET/v1/email/bulk/{id}/resultsDownload bulk results (CSV)

GET/v1/account/usageGet current API usage statistics

Request

POST /v1/email/validate
Host: api.validoapi.com
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "email": "user@example.com",
  "check_smtp": true,
  "check_disposable": true
}

200 OK Response

{
  "email": "user@example.com",
  "status": "valid",
  "score": 97,
  "checks": {
    "syntax":     true,
    "domain":     true,
    "mx_record":  true,
    "smtp":       true,
    "disposable": false,
    "catch_all":  false,
    "role_based": false
  },
  "suggestion": null,
  "response_time_ms": 132
}

Ready to start integrating?

Get Your Free API Key