API Documentation

Learn how to integrate the Email Verification API into your application.

Base URL

https://email-verification-api.nerot.me/api

Authentication

Include your API key in the request header:

X-API-Key: nrt_your_api_key_here

You can generate API keys from your API Keys dashboard.

POST /v1/verify

Verify a single email address with comprehensive checks.

Request Body

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

Query Parameters

ParameterTypeDescription
quickbooleanSkip SMTP verification for faster results
check_smtpbooleanForce SMTP check (default: true)

Response

{
  "email": "user@example.com",
  "is_valid": true,
  "risk_score": 12,
  "risk_level": "low",
  "checks": {
    "format_valid": true,
    "mx_found": true,
    "smtp_verified": true,
    "is_disposable": false,
    "is_role_account": false,
    "is_free_provider": true,
    "has_spf": true,
    "has_dmarc": true,
    "domain_age_days": 9482
  },
  "suggestion": null,
  "verification_time_ms": 342
}
GET /v1/health

Check API health status. No authentication required.

Rate Limits

PlanRate LimitDaily Limit
Free10 req/min100/day
Pro60 req/min5,000/day
Enterprise200 req/minUnlimited

Rate limit headers are included in every response: X-RateLimit-Remaining, X-RateLimit-Reset