Sovolink is a real-time email verification API. Send an email address, get back a clear verdict: valid, invalid, or risky — with full diagnostic context so you can make an informed sending decision.

The API supports single-address verification and bulk jobs. All endpoints return JSON. Authentication uses Bearer tokens.

Auth

Authentication

curl https://api.sovolink.com/api/verifications \
  -H "Authorization: Bearer sk_your_api_key_here" \
  -H "Content-Type: application/json"

Base URL & Headers

Verify a single email address. The verifier performs a syntax check, MX record lookup, SMTP handshake, and provider heuristics in one pass.

This endpoint requires authentication. For a public (rate-limited) check, use POST /api/public/verify without a Bearer token.

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

{
  "_id": "64f1a2b3c4d5e6f7a8b9c0d1",
  "email": "user@example.com",
  "status": "completed",
  "result": {
    "status": "valid",
    "reason": "smtp_ok",
    "provider": "google",
    "deliverable": true,
    "catchAll": false,
    "confidence": "high",
    "confidenceScore": 95,
    "smtpReachable": true,
    "mxHost": "aspmx.l.google.com"
  },
  "createdAt": "2024-01-15T10:00:00.000Z"
}

Bulk verification runs as a multi-step job. Create a job, upload rows in batches of up to 500, then poll until complete and download results as CSV.

{
  "fileName": "leads_march_2024.csv",
  "headers": ["email", "first_name", "company"],
  "emailColumn": "email",
  "statusColumn": "verification_status",
  "totalRows": 1000
}

Returns { id, status, total, createdAt }. Save the id — you need it for all subsequent calls.

{
  "jobId": "a1b2c3d4-...",
  "emails": ["alice@company.com", "bob@agency.io"],
  "rows": [
    ["alice@company.com", "Alice", "Company"],
    ["bob@agency.io", "Bob", "Agency"]
  ]
}

{
  "id": "a1b2c3d4-...",
  "status": "processing",
  "total": 1000,
  "completed": 340,
  "failed": 12,
  "pending": 648,
  "readyForDownload": false
}

Poll until readyForDownload is true. Recommended interval: 2–5 seconds.

Returns a CSV file with the original columns plus a status column appended (or overwritten if it already existed). The filename in Content-Disposition matches the job's original filename.

Returns cursor-paginated verification history for the authenticated user. Use nextCursor from the response as the cursor param in the next request to page through results.

{
  "error": "Human-readable error message"
}

Monthly verification quotas are enforced per account. In addition, auth endpoints are rate-limited to prevent abuse.

When you exceed your quota, the API returns a 403 error. Upgrade your plan in the billing dashboard to continue.

const API_BASE = "https://api.sovolink.com";
const API_KEY  = process.env.SOVOLINK_API_KEY;

async function verifyEmail(email) {
  const res = await fetch(`${API_BASE}/api/verifications`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": `Bearer ${API_KEY}`,
    },
    body: JSON.stringify({ email }),
  });

  if (!res.ok) {
    const err = await res.json();
    throw new Error(err.error || `HTTP ${res.status}`);
  }

  return res.json();
}

// Usage
const result = await verifyEmail("user@example.com");
console.log(result.result?.status); // "valid" | "invalid" | "risky"

import os
import requests

API_BASE = "https://api.sovolink.com"
API_KEY  = os.environ["SOVOLINK_API_KEY"]

def verify_email(email: str) -> dict:
    response = requests.post(
        f"{API_BASE}/api/verifications",
        json={"email": email},
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json",
        },
    )
    response.raise_for_status()
    return response.json()

# Usage
result = verify_email("user@example.com")
print(result["result"]["status"])  # valid | invalid | risky

<?php

$apiBase = "https://api.sovolink.com";
$apiKey  = getenv("SOVOLINK_API_KEY");

function verifyEmail(string $email): array {
    global $apiBase, $apiKey;

    $ch = curl_init("{$apiBase}/api/verifications");
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_HTTPHEADER     => [
            "Content-Type: application/json",
            "Authorization: Bearer {$apiKey}",
        ],
        CURLOPT_POSTFIELDS => json_encode(["email" => $email]),
    ]);

    $body   = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($status >= 400) {
        throw new RuntimeException("API error {$status}: {$body}");
    }

    return json_decode($body, true);
}

// Usage
$result = verifyEmail("user@example.com");
echo $result["result"]["status"]; // valid | invalid | risky