API Reference

API Documentation

Base URL: https://emailapi.swissclic.ch

Authentication

Pass your API key in the request body as api_key, or in the X-API-Key header for GET requests.

POST/api/auth/register

Create an account and receive your API key.

Request

{
  "email": "user@example.com",
  "password": "yourpassword"
}

Response

{
  "api_key": "ev_live_xxxxxxxxxxxx",
  "credits": 100
}

POST/api/verify

Verify an email address. Consumes 1 credit.

Request

{
  "email": "target@example.com",
  "api_key": "ev_live_xxxxxxxxxxxx"
}

Response

{
  "valid": true,
  "score": 0.97,
  "details": {
    "format": true,
    "mx_record": true,
    "disposable": false,
    "role_based": false,
    "ai_risk_score": 0.03
  }
}

GET/api/credits

Check remaining credits for your API key.

Request

# Pass your API key as a header
X-API-Key: ev_live_xxxxxxxxxxxx

Response

{
  "credits_remaining": 94
}

Verification Response Fields

Field	Type	Description
valid	boolean	Whether the email address is valid and safe to use
score	float 0–1	Confidence score (1.0 = fully valid)
details.format	boolean	RFC-5322 format check passed
details.mx_record	boolean	MX DNS record exists for the domain
details.disposable	boolean	Email uses a disposable/temporary domain
details.role_based	boolean	Address is a role account (info@, support@…)
details.ai_risk_score	float 0–1	AI-derived spam/fraud risk (0 = safe)