Skip to main content

Getting started

Quick start guide

Get started with Kawaa email verification in under 5 minutes.

Step 1: Create your account

Sign up for a free Kawaa account at kawaa.com/register. You'll get 100 one-time starter verifications 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

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:

{
  "success": true,
  "data": {
    "email": "test@example.com",
    "status": "risky",
    "sub_status": "catch_all",
    "quality_score": 72,
    "verification": {
      "syntax_valid": true,
      "domain_exists": true,
      "mx_found": true,
      "catch_all": true
    },
    "flags": {
      "disposable": false,
      "role_account": false,
      "free_provider": false
    },
    "credits_used": 1,
    "credits_remaining": 9994
  }
}

Read the top-level status to decide whether to send. The booleans live under flags, and the score is quality_score — there are no top-level is_* fields.

Next steps

Something wrong or missing here?

Tell us what to fix. Your email goes to the support team with this article's title already filled in.

Send feedback

Still need help?

Email support@kawaa.com. If your question is about a bulk job, include its job ID from the dashboard.

Contact support