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_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Verify an Email

Make a POST request to the /v1/verify endpoint:

cURL

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"}'

Node.js

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);

Python

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.