Quick Start Guide

1. Registration & Login

Creating Your Account

Getting started is simple and free:

1. Visit the registration page at /register
2. Provide your email address and create a secure password
3. Verify your email address (check spam folder if needed)
4. Log in with your credentials

Login Process

After registration, access your dashboard by:

• Navigating to /login
• Entering your email and password
• You'll be automatically redirected to your dashboard

2. Dashboard Overview

Your dashboard is the central hub for all email verification activities. It displays:

3. Real-Time Email Verification

Validate individual emails instantly with our real-time checker.

How to Use

1. Navigate to the "Real-Time Verification" section on your dashboard
2. Enter an email address in the input field
3. Click "Validate"
4. Results appear in 50-500ms

What You'll See

• Status: VALID, INVALID, RISKY, or UNKNOWN
• Score: 0-100 deliverability score
• Reason: Why the email was flagged
• Advanced Insights:
  • Domain age and trust score
  • Email age estimation
  • Human vs bot name analysis
  • Free email provider detection
  • Disposable email detection
  • MX records status

Performance

Real-time validation is optimized for speed:

• Simple checks: 50-100ms (syntax, disposable)
• With MX/SMTP: 200-500ms
• Full validation: 300-700ms (all 19 steps)

4. Bulk CSV Upload & Processing

Preparing Your CSV File

CSV files must follow this format:

email
john.doe@example.com
jane.smith@company.org
test@disposable.com

Upload Process

1. Click "Bulk Upload" on your dashboard
2. Select your CSV file (max size depends on your plan)
3. System validates file format and size
4. Job is created and processing begins
5. Real-time progress tracking via WebSocket

Processing Time

Processing speed varies by job size:

• 100 emails: 10-30 seconds
• 1,000 emails: 2-5 minutes
• 10,000 emails: 15-30 minutes
• 100,000+ emails: 2-5 hours

Job Status

Track your job through these states:

• PENDING - Queued for processing
• PROCESSING - Actively validating emails
• COMPLETED - Successfully finished
• FAILED - Error occurred (contact support)

5. Understanding Validation Results

Status Categories

19-Step Validation Process

Our comprehensive validation includes:

1. Syntax validation (RFC 5322 compliance)
2. Disposable email detection (50,000+ domains)
3. Role-based email detection
4. DNS domain validation
5. MX record verification
6. SMTP connection test
7. Mailbox existence check
8. Free email provider detection
9. Spam trap detection
10. Greylisting detection
11. Catch-all detection
12. Domain age validation (NEW)
13. Email age estimation (NEW)
14. ML-based name validation (NEW)
15. Bounce risk calculation
16. Deliverability scoring
17. Historical analysis
18. Reputation checking
19. Final risk assessment

6. Downloading Results

How to Download

1. Go to your dashboard
2. Find the completed job in "Recent Jobs"
3. Click the "Download" button
4. CSV file downloads immediately

Output Format

The output CSV contains all input data plus validation results:

email,status,score,reason,domain_age,email_age,human_name_score,is_disposable,mx_valid
john.doe@example.com,VALID,95,All checks passed,730,ESTABLISHED,LIKELY_HUMAN,false,true
fake@test.com,INVALID,0,Domain does not exist,0,UNKNOWN,BOT_PATTERN,false,false
temp@tempmail.com,RISKY,45,Disposable email provider,365,NEW,UNCERTAIN,true,true

Data Retention

Job results are retained based on your plan:

• Free Plan: 7 days
• Pro Plan: 30 days
• Premium Plan: 365 days

Download your results before they expire!

7. Analytics Dashboard (Pro/Premium)

Analytics dashboard is available on Pro and Premium plans.

Available Analytics

Accessing Analytics via API

Pro and Premium users can access analytics programmatically:

curl -X GET https://goemailverify.com/api/analytics/summary \
  -H "Authorization: Bearer YOUR_API_KEY"

See the API Reference for complete documentation.

8. API Key Management

Generating an API Key

1. Navigate to "API Keys" section in dashboard
2. Click "Generate New API Key"
3. Give your key a descriptive name (e.g., "Production App")
4. Copy the key immediately - it won't be shown again!
5. Store it securely (environment variables, vault, etc.)

Revoking API Keys

If a key is compromised:

1. Go to "API Keys" section
2. Find the compromised key
3. Click "Revoke"
4. Generate a new key
5. Update your applications

Key Formats

API keys follow these formats based on environment:

• sk_live_... - Production keys
• sk_test_... - Test/sandbox keys

9. API Integration

Integrate email validation into your applications using our REST API.

Example 1: cURL

# Single email validation
curl -X POST https://goemailverify.com/api/validate-emails \
  -H "Authorization: Bearer sk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"emails": ["test@example.com"]}'

# Response
{
  "email": "test@example.com",
  "status": "VALID",
  "score": 95,
  "reason": "All checks passed",
  "domainAge": 730,
  "emailAge": "ESTABLISHED",
  "humanNameScore": "LIKELY_HUMAN"
}

Example 2: Python

import requests

API_KEY = "sk_live_your_api_key_here"
BASE_URL = "https://goemailverify.com"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Single email validation
response = requests.post(
    f"{BASE_URL}/api/validate-emails",
    headers=headers,
    json={"emails": ["test@example.com"]}
)

result = response.json()
print(f"Status: {result['status']}")
print(f"Score: {result['score']}")

# Bulk CSV upload
with open('emails.csv', 'rb') as f:
    files = {'file': f}
    response = requests.post(
        f"{BASE_URL}/api/jobs/upload",
        headers={"Authorization": f"Bearer {API_KEY}"},
        files=files
    )

job = response.json()
print(f"Job ID: {job['jobId']}")

Example 3: Java

import java.net.http.*;
import java.net.URI;

public class GoEmailVerifyClient {
    private static final String API_KEY = "sk_live_your_api_key_here";
    private static final String BASE_URL = "https://goemailverify.com";

    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        // Single email validation
        String requestBody = "{\"emails\":[\"test@example.com\"]}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(BASE_URL + "/api/validate-emails"))
            .header("Authorization", "Bearer " + API_KEY)
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(requestBody))
            .build();

        HttpResponse response = client.send(
            request,
            HttpResponse.BodyHandlers.ofString()
        );

        System.out.println("Response: " + response.body());
    }
}

For complete API documentation, see API Reference.

10. Credit-Based Pricing

Credit Packages

How Credits Work

• 1 credit = 1 valid email validation
• Invalid emails = FREE (0 credits)
• Risky emails = FREE (0 credits)
• Unknown emails = FREE (0 credits)
• Credits never expire
• Purchasing more credits adds to your balance
• Volume discounts automatically applied

Example Calculation

Let's say you upload 10,000 emails:

• 7,000 emails are VALID → 7,000 credits charged
• 2,000 emails are INVALID → 0 credits charged
• 1,000 emails are RISKY → 0 credits charged
• Total cost: 7,000 credits only!

At Professional Pack pricing ($0.0065/credit), you pay only $45.50 instead of charging for all 10,000 emails.

11. Best Practices