API Documentation

Integrate email verification directly into your applications with our easy-to-use API.

Overview

The ValidateLeads API allows you to verify email addresses programmatically. You can verify individual email addresses or submit batches for bulk verification.

Base URL

https://api.ValidateLeads.com/v1

Authentication

All API requests require an API key which should be included in the X-API-Key header.

X-API-Key: YOUR_API_KEY

API Endpoints

POST

/api/verify

Verify a single email address.

Request

curl -X POST https://api.ValidateLeads.com/v1/api/verify \
    -H "Content-Type: application/json" \
    -H "X-API-Key: YOUR_API_KEY" \
    -d '{"email": "example@domain.com"}'

Response

{
    "email": "example@domain.com",
    "status": "valid",
    "verified_at": "2025-04-20T12:34:56.789Z",
    "remaining_credits": 99
}

Parameters

Parameter	Type	Required	Description
email	string	Yes	The email address to verify

POST

/api/verify-bulk

Verify multiple email addresses in a single request.

Request

curl -X POST https://api.ValidateLeads.com/v1/api/verify-bulk \
    -H "Content-Type: application/json" \
    -H "X-API-Key: YOUR_API_KEY" \
    -d '{"emails": ["example1@domain.com", "example2@domain.com", "example3@domain.com"]}'

Response

{
    "results": [
        {
            "email": "example1@domain.com",
            "status": "valid",
            "verified_at": "2025-04-20T12:34:56.789Z"
        },
        {
            "email": "example2@domain.com",
            "status": "invalid",
            "verified_at": "2025-04-20T12:34:56.789Z"
        },
        {
            "email": "example3@domain.com",
            "status": "valid",
            "verified_at": "2025-04-20T12:34:56.789Z"
        }
    ],
    "remaining_credits": 97
}

Parameters

Parameter	Type	Required	Description
emails	array	Yes	Array of email addresses to verify (maximum 1000)

Response Codes

Code	Description
200	Success
400	Bad request (e.g., missing required parameters)
401	Unauthorized (invalid or missing API key)
402	Payment required (insufficient credits)
429	Too many requests (rate limit exceeded)
500	Server error

Code Examples

// Single email verification
async function verifyEmail(email, apiKey) {
    const response = await fetch('https://api.ValidateLeads.com/v1/api/verify', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'X-API-Key': apiKey
        },
        body: JSON.stringify({ email })
    });
    
    return await response.json();
}

// Bulk email verification
async function verifyEmails(emails, apiKey) {
    const response = await fetch('https://api.ValidateLeads.com/v1/api/verify-bulk', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'X-API-Key': apiKey
        },
        body: JSON.stringify({ emails })
    });
    
    return await response.json();
}

import requests

# Single email verification
def verify_email(email, api_key):
    url = 'https://api.ValidateLeads.com/v1/api/verify'
    headers = {
        'Content-Type': 'application/json',
        'X-API-Key': api_key
    }
    data = {
        'email': email
    }
    
    response = requests.post(url, headers=headers, json=data)
    return response.json()

# Bulk email verification
def verify_emails(emails, api_key):
    url = 'https://api.ValidateLeads.com/v1/api/verify-bulk'
    headers = {
        'Content-Type': 'application/json',
        'X-API-Key': api_key
    }
    data = {
        'emails': emails
    }
    
    response = requests.post(url, headers=headers, json=data)
    return response.json()

<?php
// Single email verification
function verifyEmail($email, $apiKey) {
    $url = 'https://api.ValidateLeads.com/v1/api/verify';
    $data = [
        'email' => $email
    ];
    
    $options = [
        'http' => [
            'header' => "Content-Type: application/json\r\nX-API-Key: $apiKey",
            'method' => 'POST',
            'content' => json_encode($data)
        ]
    ];
    
    $context = stream_context_create($options);
    $result = file_get_contents($url, false, $context);
    
    return json_decode($result, true);
}

// Bulk email verification
function verifyEmails($emails, $apiKey) {
    $url = 'https://api.ValidateLeads.com/v1/api/verify-bulk';
    $data = [
        'emails' => $emails
    ];
    
    $options = [
        'http' => [
            'header' => "Content-Type: application/json\r\nX-API-Key: $apiKey",
            'method' => 'POST',
            'content' => json_encode($data)
        ]
    ];
    
    $context = stream_context_create($options);
    $result = file_get_contents($url, false, $context);
    
    return json_decode($result, true);
}
?>

Ready to Get Started?

Create Your Account