Verify one address

curl -G "https://simplecold.com/api/v1/api-validation/single" \
  --data-urlencode "[email protected]" \
  -H "Authorization: Bearer YOUR_API_KEY"

const API = "https://simplecold.com/api/v1";
const apiKey = process.env.SIMPLECOLD_API_KEY;

async function verify(email) {
  const res = await fetch(
    `${API}/api-validation/single?email=${encodeURIComponent(email)}`,
    { headers: { Authorization: `Bearer ${apiKey}` } }
  );
  const body = await res.json();
  if (!res.ok) {
    // Errors use { code: "FAILURE", message }; input errors use { success: false, message }
    throw new Error(`${res.status}: ${body.message ?? body.error}`);
  }
  return body.payload;
}

const result = await verify("[email protected]");
console.log(result.category, result.status, "-", result.statusMessage);
if (result.suggestion) console.log("Did you mean", result.suggestion, "?");

import os
import requests

API = "https://simplecold.com/api/v1"
API_KEY = os.environ["SIMPLECOLD_API_KEY"]

def verify(email: str) -> dict:
    res = requests.get(
        f"{API}/api-validation/single",
        params={"email": email},  # requests URL-encodes this for you
        headers={"Authorization": f"Bearer {API_KEY}"},
        timeout=30,
    )
    body = res.json()
    if not res.ok:
        raise RuntimeError(f"{res.status_code}: {body.get('message') or body.get('error')}")
    return body["payload"]

result = verify("[email protected]")
print(result["category"], result["status"], "-", result["statusMessage"])

<?php
const API = 'https://simplecold.com/api/v1';

function verify(string $email): array
{
    $ch = curl_init(API . '/api-validation/single?' . http_build_query(['email' => $email]));
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('SIMPLECOLD_API_KEY')],
        CURLOPT_TIMEOUT => 30,
    ]);
    $body = json_decode(curl_exec($ch), true);
    $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    if ($status >= 400) {
        // Errors use { code: "FAILURE", message }; input errors use { success: false, message }
        throw new RuntimeException($status . ': ' . ($body['message'] ?? $body['error'] ?? 'request failed'));
    }
    return $body['payload'];
}

$result = verify('[email protected]');
echo $result['category'], ' ', $result['status'], ' - ', $result['statusMessage'], PHP_EOL;
if ($result['suggestion']) {
    echo 'Did you mean ', $result['suggestion'], '?', PHP_EOL;
}

curl -G "https://simplecold.com/api/v1/api-validation/single/result" \
  --data-urlencode "[email protected]" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -G "https://simplecold.com/api/v1/api-validation/single" \
  --data-urlencode "[email protected]" \
  -H "Authorization: Bearer YOUR_API_KEY"