Spec

Extraits de code

curl "https://api.oanor.com/emailnormalize-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/emailnormalize-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/emailnormalize-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/emailnormalize-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "data": {
        "name": "Email Normalize API",
        "notes": "Strictly, the local part is case-sensitive per RFC 5321, but virtually all providers treat it case-insensitively — lowercasing is on by default for deduplication and can be turned off. Gmail dot-stripping applies only to gmail.com/googlemail.com. This normalizes for comparison; to verify deliverability (MX, disposable) use an email-verification API. Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/normalize",
                "params": {
                    "email": "the email address (required)",
                    "plus_all": "apply +tag stripping to all domains, not just known ones (default true)",
                    "lowercase": "lower-case the local part too (default true)",
                    "plus_tags": "strip +tag sub-addressing (default true)",
                    "gmail_dots": "strip dots for Gmail (default true)"
                },
                "returns": "the normalized address, the provider and the changes made"
            },
            {
                "path": "/v1/compare",
                "params": {
                    "a": "first email (required)",
                    "b": "second email (required)",
                    "…options": "same options as normalize"
                },
                "returns": "whether a and b are the same inbox, with both normalized forms"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "Canonicalize email addresses so you can deduplicate accounts and catch aliases of the same inbox. The normalize endpoint lower-cases the address, applies provider-aware rules — strips the dots from Gmail/Googlemail local parts and maps googlemail.com to gmail.com, removes +tag sub-addressing for Gmail and the many providers that support it (Outlook, iCloud, Fastmail, Proton, Yandex, Zoho and more), and optionally for all domains — and tells you exactly which changes it made. The compare endpoint normalizes two addresses and tells you whether they resolve to the same inbox. Everything is computed locally and deterministically, with no DNS or network calls. Pure local, no key."
    },
    "meta": {
        "timestamp": "2026-06-03T09:24:58.859Z",
        "request_id": "adaf0de7-a020-490f-8b69-532723b1150d"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}