Skip to main content

API reference

API authentication

All API requests must be authenticated using your API key.

Authentication methods

API key header (recommended)

Include your API key in the X-Api-Key header:

X-Api-Key: ev_your_api_key

Bearer token

Alternatively, send your API key as a Bearer token in the Authorization header:

Authorization: Bearer ev_your_api_key

Example 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": "test@example.com"}'

Authentication errors

CodeMessageSolution
401Invalid API keyCheck your API key is correct
401API key revokedGenerate a new API key
403Insufficient permissionsUpgrade your plan

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