API Documentation

Everything you need to integrate Whylidate's email verification API into your application.

Quick Start

Get started with a simple API call to verify an email address:

curl -X POST https://api.whylidate.com/v1/check_email \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to_email": "user@example.com"}'

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer whl_live_xxxxxxxxxxxx

You can create and manage API keys from your dashboard.

API Endpoints

POST/v1/check_email

Verify a single email address in real-time

POST/v1/bulk

Submit a batch of emails for verification

GET/v1/bulk/{id}

Get the status and results of a bulk verification job

GET/v1/usage

Get your current usage statistics and credit balance

POST/v1/api-keys

Create a new API key for your account

GET/v1/webhooks

List and manage webhook endpoints

Response Format

All responses are returned in JSON format. A successful email verification returns:

{
  "email": "user@example.com",
  "is_deliverable": true,
  "is_valid_syntax": true,
  "is_disposable": false,
  "is_role_based": false,
  "is_catch_all": false,
  "mx_records": ["mx1.example.com", "mx2.example.com"],
  "smtp_response": "250 OK"
}