Email Verification API Documentation

Base URL

https://bounceguard.net/api/v1

Authentication

All requests must include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

How to get your API key:

1. Log in to your BounceGuard account
2. Go to the Integration page
3. Click "Generate New API Key"
4. Copy the generated key (it will be shown only once)

Keep your API key secure. Do not share it publicly.

Endpoint: Validate Single Email

POST /validate-email
Validates a single email address and returns detailed result.

Request Example

curl -X POST https://bounceguard.net/api/v1/validate-email \
  -H "Authorization: Bearer 97ff7090dd1915eb8c24e2973ef6d12f" \
  -H "Content-Type: application/json" \
  -d '{"email": "username@example.com"}'

Request Body (JSON)

{
  "email": "username@example.com"
}

Response (Success)

{
  "status": "success",
  "email": "username@example.com",
  "result": "Valid",
  "reason": "Mailbox confirmed to exist",
  "remaining_credits": 95899371
}

Possible Results

Error Responses

{"status": "error", "message": "Invalid API key"}

{"status": "error", "message": "Insufficient credits", "remaining_credits": 0}

{"status": "error", "message": "Valid email required"}

Rate Limits & Credits

• Each validation costs 1 credit
• No strict rate limit — but excessive use may be throttled
• Monitor remaining_credits in response

Code Examples

Python Email Verification Snippet

import requests
url = "https://bounceguard.net/api/v1/validate-email"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {"email": "username@example.com"}
response = requests.post(url, headers=headers, json=data)
print(response.json())

Node.js Email Validation Library

fetch('https://bounceguard.net/api/v1/validate-email', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ email: 'username@example.com' })
})
.then(res => res.json())
.then(data => console.log(data));

PHP Email Checker API

$ch = curl_init('https://bounceguard.net/api/v1/validate-email');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['email' => 'username@example.com']));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
echo $response;

Common Use Cases

1. Prevent Fake Signups

Validate emails in real-time during registration to stop bots and fake accounts. Our low-latency API returns results in milliseconds — perfect for seamless user experience.

2. Clean CRM Data

Sync with HubSpot, Salesforce, or any CRM. Run bulk validation on your existing contacts to maintain high deliverability and protect sender reputation.

3. E-commerce Checkout

Verify guest checkout emails instantly. Reduce failed order notifications and abandoned carts caused by typos or invalid addresses.

Best Practices

• Always check the result field before sending emails
• Cache results when possible (same email → same result usually)
• Handle errors gracefully in your application
• Regenerate API key if compromised

Support

Need help integrating? Contact support@bounceguard.net

Happy validating! 🚀