Skip to main content

Getting started

Making your first verification

Learn how to verify your first email address using the Kawaa API.

Single email verification

The simplest way to verify an email is using a POST request:

curl -X POST https://api.kawaa.com/v1/verify \
  -H "X-Api-Key: ev_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "john@example.com"}'

Using our SDKs

We provide published packages for Node.js and Python. Clients for other languages are not yet published; from those languages, call the REST API directly.

Python

from kawaa import Kawaa

client = Kawaa(api_key="YOUR_API_KEY")
result = client.verify("john@example.com")
print(result.status)  # "valid" or "invalid"

Node.js

const { Kawaa } = require('kawaa');

const client = new Kawaa('YOUR_API_KEY');
const result = await client.verify('john@example.com');
console.log(result.status);

Testing in the dashboard

You can also test email verification directly in your dashboard without writing any code. Go to the Dashboard and use the single verification form.

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