API Documentation

Getting Started

The Emvalio API allows you to validate email addresses programmatically. All API requests require authentication using your API key.

Authentication

Include your API key in the request header:

X-API-Key: emv_your_api_key_here

Validate Single Email

Query Parameters

Parameter	Type	Description
email	string	Email address to validate (required)
level	string	Validation level: "quick" or "full" (default: "full")

Example Request

curl -X GET "https://emvalio.com/api/validate?email=user@example.com" \
  -H "X-API-Key: emv_your_api_key_here"

Example Response

{
  "valid": true,
  "email": "user@example.com",
  "result": {
    "syntax_valid": true,
    "dns_valid": true,
    "smtp_valid": true,
    "catch_all": false,
    "deliverable": true,
    "risk_score": 0
  },
  "cached": false,
  "credits_remaining": 99
}

POST Request

Request Body

{
  "email": "user@example.com",
  "level": "full"
}

Example Request

curl -X POST "https://emvalio.com/api/validate" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: emv_your_api_key_here" \
  -d '{"email": "user@example.com"}'

Response Fields

Field	Type	Description
valid	boolean	Overall email validity
syntax_valid	boolean	RFC-compliant email format
dns_valid	boolean	Domain has valid MX/A records
smtp_valid	boolean	Mailbox exists (full validation only)
catch_all	boolean	Domain accepts all emails
deliverable	boolean	Email is likely deliverable
risk_score	number	Risk score 0-100 (lower is better)

Error Responses

Status	Error	Description
400	missing_email	Email parameter is required
401	invalid_api_key	Invalid API key provided
402	credits_exhausted	Monthly credits limit exceeded
429	rate_limited	Too many requests