Kanta API

Fast integration for single and bulk email verification. Generate your API key at app.kanta.dev.

Authentication

Generate an API key from your dashboard at app.kanta.dev. Include it in every request:

X-API-Key: your_api_key_here

Base URL:

https://api.kanta.dev

Status Values

valid

SMTP confirmed deliverable, not catch-all.

invalid

SMTP rejected or no MX records.

risky

Catch-all domain or role-based address — deliverable but high bounce risk.

unknown

Server timed out, greylisted, or blocked the probe.

disposable

Known throwaway domain.

Core Endpoints

POST

/verify

Verify a single email address synchronously. Returns a result immediately (up to 15s).

{
  "email": "[email protected]"
}

POST

/verify/bulk

Submit a list for background processing. Returns a job_id immediately.

{
  "emails": ["[email protected]", "[email protected]"],
  "webhook_url": "https://yourapp.com/kanta-webhook"
}

GET

/jobs/{job_id}

Check bulk job status and progress.

GET

/jobs/{job_id}/results

Fetch full results array. Only available when status is complete.

GET

/credits

Check your credit balance and recent ledger entries.

Sample Response — /verify

{
  "email": "[email protected]",
  "status": "valid",
  "mx_valid": true,
  "catch_all": false,
  "disposable": false,
  "role_based": false,
  "provider_blocked": false,
  "credits_remaining": 842
}

Error Format

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests for this key.",
    "request_id": "req_8f0b2b"
  }
}