API Documentation

// Using fetch API
const validateEmail = async (email) => {
  try {
    const response = await fetch('https://clearmiq.com/api/validate', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_API_KEY'
      },
      body: JSON.stringify({ email })
    });
    
    const result = await response.json();
    console.log('Validation result:', result);
    return result;
  } catch (error) {
    console.error('Validation failed:', error);
  }
};

// Validate single email
validateEmail('test@example.com');

import requests
import json

def validate_email(email, api_key):
    url = "https://clearmiq.com/api/validate"
    headers = {
        'Content-Type': 'application/json',
        'Authorization': f'Bearer {api_key}'
    }
    data = {'email': email}
    
    try:
        response = requests.post(url, headers=headers, json=data)
        response.raise_for_status()
        return response.json()
    except requests.RequestException as e:
        print(f'Validation failed: {e}')
        return None

# Example usage
result = validate_email('test@example.com', 'YOUR_API_KEY')
print(json.dumps(result, indent=2))

<?php
function validateEmail($email, $apiKey) {
    $url = "https://clearmiq.com/api/validate";
    $data = json_encode(['email' => $email]);
    
    $options = [
        'http' => [
            'header' => [
                'Content-Type: application/json',
                'Authorization: Bearer ' . $apiKey
            ],
            'method' => 'POST',
            'content' => $data
        ]
    ];
    
    $context = stream_context_create($options);
    $result = file_get_contents($url, false, $context);
    
    return json_decode($result, true);
}

// Example usage
$result = validateEmail('test@example.com', 'YOUR_API_KEY');
echo json_encode($result, JSON_PRETTY_PRINT);
?>

const axios = require('axios');

class EmailValidator {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseUrl = 'https://clearmiq.com';
  }
  
  async validateSingle(email) {
    try {
      const response = await axios.post(`${this.baseUrl}/api/validate`, {
        email: email
      }, {
        headers: {
          'Authorization': `Bearer ${this.apiKey}`,
          'Content-Type': 'application/json'
        }
      });
      
      return response.data;
    } catch (error) {
      throw new Error(`Validation failed: ${error.message}`);
    }
  }
  
  async validateBulk(emails) {
    try {
      const response = await axios.post(`${this.baseUrl}/api/validate/bulk`, {
        emails: emails
      }, {
        headers: {
          'Authorization': `Bearer ${this.apiKey}`,
          'Content-Type': 'application/json'
        }
      });
      
      return response.data;
    } catch (error) {
      throw new Error(`Bulk validation failed: ${error.message}`);
    }
  }
}

// Example usage
const validator = new EmailValidator('YOUR_API_KEY');

// Single email validation
validator.validateSingle('test@example.com')
  .then(result => console.log(result))
  .catch(error => console.error(error));

// Bulk email validation
validator.validateBulk(['email1@test.com', 'email2@test.com'])
  .then(results => console.log(results))
  .catch(error => console.error(error));