Verification API

Verify a single email address in real-time and get detailed results including deliverability status, risk flags, and enrichment data.

Endpoint

POST/v1/verify

Request Body

Parameter	Type	Required	Description
`email`	string	Yes	Email address to verify
`include_activity`	boolean	No	Include engagement activity data (default: false)
`options.deep_verify`	boolean	No	Perform extended SMTP checks (default: true)
`options.include_ai`	boolean	No	Include AI-powered analysis (default: true)

Example Request

cURL

curl -X POST https://api.kawaa.com/v1/verify \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "john@example.com",
    "include_activity": true,
    "options": {
      "deep_verify": true,
      "include_ai": true
    }
  }'

Response

200 OK

{
  "success": true,
  "data": {
    "email": "john@example.com",
    "status": "valid",
    "quality_score": 95,
    "verification": {
      "syntax_valid": true,
      "domain_exists": true,
      "mx_found": true,
      "smtp_check": true,
      "mailbox_exists": true,
      "catch_all": false
    },
    "flags": {
      "disposable": false,
      "role_account": false,
      "free_provider": false,
      "spam_trap": false,
      "honeypot": false,
      "bot_generated": false
    },
    "enrichment": {
      "first_name": "John",
      "last_name": null,
      "full_name": "John",
      "gender": "male"
    },
    "ai": {
      "typo_suggestion": null,
      "typo_confidence": null,
      "catch_all_confidence": 15
    },
    "activity": {
      "last_seen": "2026-01-15T10:30:00Z",
      "engagement_level": "high",
      "opens_last_30d": 12,
      "clicks_last_30d": 5
    },
    "verified_at": "2026-02-03T14:22:15.123Z"
  }
}

Response Fields

Status Values

Status	Description
`valid`	Email is deliverable and safe to send
`invalid`	Email will bounce - do not send
`risky`	Email may be deliverable but has risk factors
`unknown`	Could not determine deliverability
`catch_all`	Domain accepts all emails - individual mailbox unverifiable
`disposable`	Temporary email address
`role`	Role-based email (info@, support@)
`spam_trap`	Known spam trap - do not send

Quality Score

The quality_score is a 0-100 score indicating overall email quality:

90-100: Excellent - Safe to send
70-89: Good - Generally safe
50-69: Fair - Review recommended
0-49: Poor - High risk of issues

Credits

1 credit per verification (cache miss)
0.5 credits for cached results (within 24 hours)
Activity data included at no extra cost when available