Create a free account, get an API key and verify your first address: getting started with Kawaa takes about five minutes.
Step 1: Create your account
Sign up for a free Kawaa account at kawaa.com/register. You'll get 100 starter credits (no monthly renewal) to test our service.
Step 2: Get your API key
After logging in, navigate to Settings → API keys and click "Create API key". Copy your API key and store it securely.
Step 3: Make your first API call
Each verification uses 1 credit, or 0.5 when the result comes from cache.
curl -X POST https://api.kawaa.com/v1/verify \
-H "X-Api-Key: ev_your_api_key" \
-H "Content-Type: application/json" \
-d '{"email": "test@example.com"}'Step 4: Understand the response
Every response is wrapped in an envelope. On success, success is true and the verification result is under data. This is what the request above normally returns (trimmed):
{
"success": true,
"data": {
"email": "test@example.com",
"status": "invalid",
"sub_status": "no_mx",
"quality_score": 10,
"verification": {
"syntax_valid": true,
"domain_exists": true,
"mx_found": false,
"greylisted": false
},
"flags": {
"disposable": false,
"role_account": false,
"free_provider": false,
"spam_trap": false,
"abuse_email": false,
"honeypot": false,
"complainer": false,
"bot_generated": false
},
"credits_used": 1,
"credits_remaining": 99
}
}example.com is reserved for documentation and accepts no mail, so it comes back invalid with the reason no_mx or, if a DNS lookup fails at that moment, unknown with temporary_failure. Try an address you own to see a valid result.
Read the top-level status to decide whether to send; it is one of eight values, explained in Verification statuses explained. sub_status says why. The booleans live under flags, and the score is quality_score. There are no top-level is_* fields.