API Documentation

https://staging.disposableemailapi.com/api/v1

Content-Type: application/json
X-API-Key: YOUR_API_KEY_HERE

const axios = require('axios');

async function checkDisposableEmail(email) {
  try {
    const response = await axios.get(`https://staging.disposableemailapi.com/api/v1/check`, {
      params: { email },
      headers: {
        'X-API-Key': process.env.DISPOSABLE_EMAIL_API_KEY
      }
    });
    
    const { data } = response.data;
    console.log(`Email ${email} is ${data.is_disposable ? 'disposable' : 'legitimate'}`);
    console.log(`Risk score: ${data.risk_score}/100`);
    
    return data;
  } catch (error) {
    console.error('API request failed:', error.response?.data || error.message);
    throw error;
  }
}

// Usage
checkDisposableEmail('[email protected]');

<?php

function checkDisposableEmail($email, $apiKey) {
    $url = 'https://staging.disposableemailapi.com/api/v1/check?' . http_build_query(['email' => $email]);
    
    $options = [
        'http' => [
            'header' => [
                'X-API-Key: ' . $apiKey,
                'Content-Type: application/json'
            ],
            'method' => 'GET'
        ]
    ];
    
    $context = stream_context_create($options);
    $result = file_get_contents($url, false, $context);
    
    if ($result === false) {
        throw new Exception('API request failed');
    }
    
    $data = json_decode($result, true);
    
    if ($data['status'] !== 'success') {
        throw new Exception('API returned error: ' . ($data['message'] ?? 'Unknown error'));
    }
    
    return $data['data'];
}

// Usage
try {
    $result = checkDisposableEmail('[email protected]', 'your-api-key');
    echo "Email is " . ($result['is_disposable'] ? 'disposable' : 'legitimate') . "\n";
    echo "Risk score: " . $result['risk_score'] . "/100\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

import requests
import os

def check_disposable_email(email):
    """Check if an email address is disposable"""
    
    url = "https://staging.disposableemailapi.com/api/v1/check"
    headers = {
        'X-API-Key': os.getenv('DISPOSABLE_EMAIL_API_KEY')
    }
    params = {'email': email}
    
    try:
        response = requests.get(url, headers=headers, params=params)
        response.raise_for_status()
        
        data = response.json()
        
        if data['status'] != 'success':
            raise Exception(f"API error: {data.get('message', 'Unknown error')}")
        
        result = data['data']
        print(f"Email {email} is {'disposable' if result['is_disposable'] else 'legitimate'}")
        print(f"Risk score: {result['risk_score']}/100")
        
        return result
        
    except requests.RequestException as e:
        print(f"Request failed: {e}")
        raise

# Usage
if __name__ == "__main__":
    try:
        result = check_disposable_email('[email protected]')
    except Exception as e:
        print(f"Error: {e}")

{
  "status": "error",
  "error": "Validation failed",
  "message": "The provided email address is not valid",
  "errors": {
    "email": ["The email field must be a valid email address."]
  }
}