Official SDKs

npm install @mailbeam/sdk
# or
pnpm add @mailbeam/sdk

import Mailbeam from "@mailbeam/sdk";

const mb = new Mailbeam({ apiKey: process.env.MAILBEAM_KEY });

const result = await mb.verify("user@example.com");
console.log(result.valid, result.score);

pip install mailbeam

import mailbeam

mb = mailbeam.Client(api_key=os.environ["MAILBEAM_KEY"])

# Async (recommended for FastAPI, etc.)
result = await mb.verify("user@example.com")

# Sync
result = mb.verify_sync("user@example.com")
print(result.valid, result.score)

composer require mailbeam/mailbeam-php

use Mailbeam\Client;

$mb = new Client($_ENV['MAILBEAM_KEY']);
$result = $mb->verify('user@example.com');

echo $result->valid ? 'valid' : 'invalid';
echo $result->score;

gem install mailbeam
# or add to Gemfile:
gem 'mailbeam'

require 'mailbeam'

mb = Mailbeam::Client.new(api_key: ENV['MAILBEAM_KEY'])
result = mb.verify('user@example.com')

puts result.valid   # => true
puts result.score   # => 94

go get github.com/mailbeam/mailbeam-go

package main

import (
    "context"
    "fmt"
    "os"

    mb "github.com/mailbeam/mailbeam-go"
)

func main() {
    client := mb.NewClient(os.Getenv("MAILBEAM_KEY"))

    result, err := client.Verify(context.Background(), "user@example.com")
    if err != nil {
        panic(err)
    }

    fmt.Println(result.Valid, result.Score)
}