Get started
Quick start
Verify your first email in under 5 minutes. This guide will walk you through the basics of using the Kawaa API.
Prerequisites
- A Kawaa account (sign up free)
- An API key from your Dashboard
Get your API key
Navigate to Settings → API keys in your dashboard and create a new API key. Copy it somewhere safe.
ev_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxVerify an email
Make a POST request to the
/v1/verifyendpoint:curl -X POST https://api.kawaa.com/v1/verify \ -H "X-Api-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"email": "test@example.com"}'const response = await fetch('https://api.kawaa.com/v1/verify', { method: 'POST', headers: { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ email: 'test@example.com' }), }); const result = await response.json(); console.log(result);import requests response = requests.post( 'https://api.kawaa.com/v1/verify', headers={'X-Api-Key': 'YOUR_API_KEY'}, json={'email': 'test@example.com'} ) print(response.json())Understand the response
The API returns detailed verification results:
Response{ "success": true, "data": { "email": "test@example.com", "status": "risky", "quality_score": 72, "verification": { "syntax_valid": true, "domain_exists": true, "mx_found": true, "catch_all": false }, "flags": { "disposable": false, "role_account": false, "free_provider": true, "spam_trap": false } } }
Status values
| Status | Description | Action |
|---|---|---|
| valid | SMTP accepted the address and no catch-all/provider-limited caveat was detected during this run | Low risk |
| invalid | No valid mail server or SMTP rejected the mailbox | Do not send |
| risky | May receive mail, but risk signals or incomplete proof remain | Use with caution |
| unknown | Could not verify | Retry or review manually |
Learn how provider limits affect result interpretation in Understanding results & provider limits.