Pydantic v2 email and phone validation with email-validator and phonenumbers: working versions (tested 2026-10-15)

pydantic==2.14.1
email-validator==2.3.0
phonenumbers==9.0.41
pytest==9.1.1

from typing import Annotated

import phonenumbers
from phonenumbers import PhoneNumberFormat
from pydantic import AfterValidator, BaseModel, EmailStr


def _normalize_phone(value: str) -> str:
    try:
        # No default region: numbers must include a country code.
        num = phonenumbers.parse(value, None)
    except phonenumbers.NumberParseException as exc:
        # NumberParseException is not a ValueError, so pydantic would not
        # wrap it in ValidationError. Re-raise as ValueError.
        raise ValueError(str(exc)) from exc
    if not phonenumbers.is_valid_number(num):
        raise ValueError("invalid phone number")
    return phonenumbers.format_number(num, PhoneNumberFormat.E164)


Phone = Annotated[str, AfterValidator(_normalize_phone)]


class Contact(BaseModel):
    email: EmailStr
    phone: Phone

import pytest
from pydantic import ValidationError

from models import Contact


def test_normalizes_phone_to_e164():
    c = Contact(email="ada@example.com", phone="+1 650 253 0000")
    assert c.phone == "+16502530000"


def test_email_requires_dotted_domain():
    # email-validator rejects domains without a period, e.g. "localhost".
    with pytest.raises(ValidationError):
        Contact(email="ada@localhost", phone="+1 650 253 0000")


def test_unparseable_phone_is_validation_error():
    # phonenumbers raises NumberParseException, which must surface as ValidationError.
    with pytest.raises(ValidationError) as info:
        Contact(email="ada@example.com", phone="call me")
    assert "phone" in str(info.value)


def test_national_number_without_region_rejected():
    with pytest.raises(ValidationError):
        Contact(email="ada@example.com", phone="650 253 0000")


def test_invalid_phone_rejected():
    with pytest.raises(ValidationError):
        Contact(email="ada@example.com", phone="+1 650 253 000")

[pytest]
pythonpath = .