ValidInk

Documentation

Everything you need to integrate email validation into your application

Quick Start

Get started with email validation in minutes

API Reference

Complete API endpoint documentation

Integration Guides

Code examples in multiple languages

Security

Best practices and security guidelines

Quick Start

1. Get Your API Key

Sign up and get your API key from the dashboard settings.

API Key: evp_xxxxxxxxxxxxxxxxxxxxxx

2. Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

3. Validate Your First Email

curl -X POST https://api.validink.io/api/v1/validate/comprehensive \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

API Reference

Comprehensive Validation

POST /api/v1/validate/comprehensive

Request:

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

Response:

{
  "success": true,
  "data": {
    "email": "user@example.com",
    "is_valid": true,
    "is_disposable": false,
    "fraud_score": 0.1,
    "risk_level": "low",
    "domain_reputation": 0.95
  }
}

Batch Validation

POST /api/v1/validate/batch

Request:

{
  "emails": [
    "user1@example.com",
    "user2@example.com"
  ]
}

Integration Examples

Node.js

const axios = require('axios');

const apiKey = 'YOUR_API_KEY';
const email = 'test@example.com';

async function validateEmail(email) {
  try {
    const response = await axios.post(
      'https://api.validink.io/api/v1/validate/comprehensive',
      { email },
      {
        headers: {
          'Authorization': `Bearer ${apiKey}`,
          'Content-Type': 'application/json'
        }
      }
    );
    
    console.log(response.data);
  } catch (error) {
    console.error('Validation failed:', error);
  }
}

validateEmail(email);

Python

import requests

api_key = 'YOUR_API_KEY'
email = 'test@example.com'

def validate_email(email):
    url = 'https://api.validink.io/api/v1/validate/comprehensive'
    headers = {
        'Authorization': f'Bearer {api_key}',
        'Content-Type': 'application/json'
    }
    data = {'email': email}
    
    response = requests.post(url, json=data, headers=headers)
    return response.json()

result = validate_email(email)
print(result)

PHP

<?php

$apiKey = 'YOUR_API_KEY';
$email = 'test@example.com';

$ch = curl_init('https://api.validink.io/api/v1/validate/comprehensive');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'email' => $email
]));

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

Security Best Practices

API Key Security

• Never expose API keys in client-side code

• Rotate keys regularly

• Use environment variables to store keys

• Implement IP whitelisting when possible

Rate Limiting

Default limits by plan:

  • • Free: 100 requests/minute
  • • Pro: 500 requests/minute
  • • Enterprise: Custom limits