addrlyq / addrly-php

v1.0.1 2026-05-08 17:00 UTC

Requires

• php: >=7.4
• ext-curl: *
• ext-json: *

MIT

• Addrly

• email
• validation
• spam
• domain
• MX
• gate
• disposable
• verification
• addrly

Published on Packagist.org on 2026-05-08 17:06 UTC

README

Official PHP SDK for the Addrly email validation API.

Install

composer require addrlyq/addrly-php

Quick Start

<?php
require_once 'vendor/autoload.php';

$client = new \Addrly\Addrly('sk_your_api_key');

// Validate an email
$result = $client->validateEmail('[e-mail]');
echo $result['mx'];         // true
echo $result['disposable'];  // false

// Validate a domain
$domain = $client->validateDomain('example.com');

// Auto-detect (email or domain)
$auto = $client->validate('[e-mail]');

Bulk Validation

// Bulk email validation (Pro: 500, Ultra: 1000)
$bulk = $client->bulkValidateEmails([
    '[e-mail]',
    '[e-mail]',
    '[e-mail]',
]);
print_r($bulk['summary']);

// Bulk domain validation
$domains = $client->bulkValidateDomains(['gmail.com', 'tempmail.com']);

Gates

$decision = $client->gate('gate_abc123def456', [
    'email' => '[e-mail]',
]);
echo $decision['decision']['action']; // "block"

Error Handling

use Addrly\AddrlyException;

try {
    $result = $client->validateEmail('[e-mail]');
} catch (AddrlyException $e) {
    echo $e->getStatus();    // 429
    echo $e->getError();     // "Rate limit exceeded"
    print_r($e->getResponse());
}

Requirements

• PHP 7.4+
• ext-curl
• ext-json
• No external dependencies