The Email Verification API Built for Scale

# ── Single email verification ──────────────────────────────
curl -X POST https://zuhal.io/api/v1/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@domain.com"}'

# ── Upload a bulk CSV ──────────────────────────────────────
curl -X POST https://zuhal.io/api/v1/bulk/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/emails.csv" \
  -F "name=My List"

# ── Poll bulk job status ───────────────────────────────────
curl https://zuhal.io/api/v1/bulk/status/JOB_UUID \
  -H "Authorization: Bearer YOUR_API_KEY"

# ── Get result download link ──────────────────────────────
curl https://zuhal.io/api/v1/bulk/download/JOB_UUID \
  -H "Authorization: Bearer YOUR_API_KEY"

<?php
// ── Single email verification ──────────────────────────────
$apiKey = 'YOUR_API_KEY';

$ch = curl_init('https://zuhal.io/api/v1/verify');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer $apiKey",
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['email' => 'user@domain.com']),
]);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

echo $response['email_status']; // "valid"

// ── Upload a bulk CSV ──────────────────────────────────────
$ch = curl_init('https://zuhal.io/api/v1/bulk/upload');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["Authorization: Bearer $apiKey"],
    CURLOPT_POSTFIELDS     => [
        'file' => new CURLFile('/path/to/emails.csv'),
        'name' => 'My List',
    ],
]);
$job = json_decode(curl_exec($ch), true);
curl_close($ch);
echo $job['uuid']; // save this UUID

import requests

API_KEY  = "YOUR_API_KEY"
BASE_URL = "https://zuhal.io/api/v1"
HEADERS  = {"Authorization": f"Bearer {API_KEY}"}

# ── Single email verification ──────────────────────────────
resp = requests.post(
    f"{BASE_URL}/verify",
    headers=HEADERS,
    json={"email": "user@domain.com"},
)
data = resp.json()
print(data["email_status"])   # "valid"

# ── Upload a bulk CSV ──────────────────────────────────────
with open("emails.csv", "rb") as f:
    job = requests.post(
        f"{BASE_URL}/bulk/upload",
        headers=HEADERS,
        files={"file": (f.name, f, "text/csv")},
        data={"name": "My List"},
    ).json()
uuid = job["uuid"]

# ── Poll until complete ────────────────────────────────────
import time
while True:
    s = requests.get(f"{BASE_URL}/bulk/status/{uuid}", headers=HEADERS).json()
    if s["job_status"] in ("completed", "failed"):
        break
    time.sleep(10)

# ── Download results ───────────────────────────────────────
dl = requests.get(f"{BASE_URL}/bulk/download/{uuid}", headers=HEADERS).json()
csv_resp = requests.get(dl["download_url"])
with open("results.csv", "wb") as f:
    f.write(csv_resp.content)

// ── Single email verification (Node.js / fetch API) ────────
const API_KEY  = 'YOUR_API_KEY';
const BASE_URL = 'https://zuhal.io/api/v1';

async function verifySingle(email) {
  const res = await fetch(`${BASE_URL}/verify`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ email }),
  });
  return res.json();
}

// ── Upload a bulk CSV (Node.js FormData) ───────────────────
const { FormData } = require('formdata-node');
const { fileFromPath } = require('formdata-node/file-from-path');

async function bulkUpload(csvPath) {
  const form = new FormData();
  form.set('file', await fileFromPath(csvPath));
  form.set('name', 'My List');

  const res = await fetch(`${BASE_URL}/bulk/upload`, {
    method: 'POST',
    headers: { 'Authorization': `Bearer ${API_KEY}` },
    body: form,
  });
  const job = await res.json();
  return job.uuid;
}