KANTA
Book Demo Contact Sales
LIGHTWEIGHT DOCS

Kanta API

Fast integration for single lookups and bulk workflows. Finder and Verifier consume credits from the same account balance.

Authentication

Use your API key in the Authorization header:

Authorization: Bearer kanta_live_xxx

Base URL:

https://api.kanta.ai/v1

Response Classes

valid

Mailbox accepted by server.

invalid

Mailbox rejected explicitly.

catch_all

Domain accepts most mailbox names.

risky

Temporary or inconclusive response.

policy_limited

Provider behavior constrained probe certainty.

freshness_aware

Scoring reflects last checked age.

Core Endpoints

POST

/finder/single

Find a likely email for one person.

{
  "first_name": "Avery",
  "last_name": "Chen",
  "company": "example.com"
}
POST

/verifier/single

Verify one email address and return classification + confidence.

{
  "email": "avery.chen@example.com"
}
POST

/verifier/bulk

Submit a list of emails for asynchronous processing.

{
  "emails": ["a@example.com", "b@example.com"],
  "webhook_url": "https://yourapp.com/kanta-webhook"
}
GET

/jobs/{job_id}

Check bulk job status and progress counters.

Sample Success Response

{
  "email": "avery.chen@example.com",
  "status": "valid",
  "confidence_score": 97,
  "catch_all": false,
  "smtp_response": "250 2.1.5 OK",
  "last_checked_at": "2026-05-13T20:15:10Z",
  "credits_used": 1
}

Error Format

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