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.

kw_live_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": "valid",
    "quality_score": 95,
    "verification": {
      "syntax_valid": true,
      "domain_exists": true,
      "mx_found": true,
      "smtp_check": true,
      "mailbox_exists": true,
      "catch_all": false
    },
    "flags": {
      "disposable": false,
      "role_account": false,
      "free_provider": true,
      "spam_trap": false
    }
  }
}

Status Values

Status	Description	Action
valid	Email is deliverable	Safe to send
invalid	Email will bounce	Do not send
risky	Deliverable but may cause issues	Use with caution
unknown	Could not verify	Retry or review manually