EmailAddress.ai
    API Documentation

    API Reference

    REST API for email verification and data access. Get started in minutes.

    Trusted by Global Clients and Agencies

    OracleGE HealthcarePhilipsMayne PharmaAstraZenecaThermo FisherAdobe

    Authentication

    All API requests require an API key passed as a Bearer token in the Authorization header.

    # Example Request
    curl -X POST \
    https://api.emailaddress.ai/v1/verify \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"email":"[email protected]"}'

    Single Verification

    POST /v1/verify, Verify a single email address with full catch-all resolution.

    // Response
    {
    "email": "[email protected]",
    "status": "deliverable",
    "catch_all": true,
    "confidence": 97.4,
    "resolved": true,
    "mx_valid": true,
    "role_account": false,
    "disposable": false
    }

    Bulk Verification

    POST /v1/bulk, Submit up to 1,000,000 emails per batch. Results delivered via webhook or polling.

    // Request
    {
    "emails": ["[email protected]", "[email protected]"],
    "webhook_url": "https://your.app/results"
    }
    // Response
    {
    "job_id": "j_abc123xyz",
    "status": "queued",
    "count": 2
    }

    SDKs & Rate Limits

    Official client libraries and rate limit information.

    P
    Python SDK
    emailaddress-ai/python
    N
    Node.js SDK
    emailaddress-ai/node.js
    G
    Go SDK
    emailaddress-ai/go
    P
    PHP SDK
    emailaddress-ai/php
    Starter1,000 req/min
    Growth10,000 req/min
    Enterprise50,000+ req/min