Quickstart: your first verification in five minutes

import { SimpleVerifier } from "simpleverifier";

const sv = new SimpleVerifier(); // reads SIMPLEVERIFIER_KEY

const result = await sv.verifyEmail("jane@company.com");
console.log(result.status, result.send_advice); // "valid" "safe"

if (result.status === "invalid") {
  // ask the visitor for another address
}

import { SimpleVerifier, PaymentRequiredError, RateLimitError } from "simpleverifier";

try {
  await sv.verifyEmail(email);
} catch (error) {
  if (error instanceof PaymentRequiredError) {
    // plan has no API access, or the yearly quota is used
  } else if (error instanceof RateLimitError) {
    // already retried twice; error.retryAfter is the wait in seconds
  } else {
    throw error;
  }
}

from simpleverifier import SimpleVerifier

sv = SimpleVerifier()  # reads SIMPLEVERIFIER_KEY

result = sv.verify_email("jane@company.com")
print(result["status"], result.get("send_advice"))  # valid safe

if result["status"] == "invalid":
    ...  # ask the visitor for another address

from simpleverifier import PaymentRequiredError, RateLimitError

try:
    sv.verify_email(email)
except PaymentRequiredError:
    ...  # plan has no API access, or the yearly quota is used
except RateLimitError as error:
    ...  # already retried twice; error.retry_after is the wait in seconds

<?php
require "src/Exceptions.php";
require "src/Client.php";

$sv = new SimpleVerifier\Client(); // reads SIMPLEVERIFIER_KEY

$result = $sv->verifyEmail("jane@company.com");
echo $result["status"], " ", $result["send_advice"] ?? "";

if ($result["status"] === "invalid") {
    // ask the visitor for another address
}

try {
    $sv->verifyEmail($email);
} catch (SimpleVerifier\PaymentRequiredException $e) {
    // plan has no API access, or the yearly quota is used
    // $e->retryAfter is the seconds until the quota resets when present
} catch (SimpleVerifier\RateLimitException $e) {
    // already retried twice
}

go get github.com/Ahmedmkarrar/simpleverifier-go@latest

package main

import (
	"context"
	"fmt"

	simpleverifier "github.com/Ahmedmkarrar/simpleverifier-go"
)

func main() {
	c, err := simpleverifier.New("") // reads SIMPLEVERIFIER_KEY
	if err != nil {
		panic(err)
	}
	res, err := c.Verify(context.Background(), "jane@company.com")
	if err != nil {
		panic(err)
	}
	fmt.Println(res.Status, res.SendAdvice)
}

_, err := c.Verify(ctx, email)
var apiErr *simpleverifier.APIError
switch {
case errors.Is(err, simpleverifier.ErrPaymentRequired):
	// plan has no API access, or the yearly quota is used
case errors.Is(err, simpleverifier.ErrRateLimited):
	// already retried twice
case errors.As(err, &apiErr):
	fmt.Println(apiErr.Status, apiErr.Message, apiErr.RetryAfter)
}

require "simpleverifier"

sv = SimpleVerifier::Client.new # reads SIMPLEVERIFIER_KEY

result = sv.verify_email("jane@company.com")
puts "#{result["status"]} #{result["send_advice"]}"

if result["status"] == "invalid"
  # ask the visitor for another address
end

begin
  sv.verify_email(email)
rescue SimpleVerifier::PaymentRequiredError => e
  # plan has no API access, or the yearly quota is used; e.retry_after may be set
rescue SimpleVerifier::RateLimitError
  # already retried twice
end