Pydantic Extra Types

Common errors

Warnings

Install

Install compatibility verified last tested: 2026-05-12

Imports

• Color
  wrong

  from pydantic import Color

  correct

  from pydantic_extra_types.color import Color

  The `Color` type was moved from the main Pydantic library to pydantic-extra-types in Pydantic V2.

• PhoneNumber

  from pydantic_extra_types.phone_numbers import PhoneNumber

  Requires the `phonenumbers` optional dependency.

• CountryAlpha2

  from pydantic_extra_types.country import CountryAlpha2

  Requires the `pycountry` optional dependency.

• SemanticVersion
  wrong

  from pydantic_extra_types.semver import SemanticVersion

  correct

  from pydantic_extra_types.semantic_version import SemanticVersion

  The `semver` module was deprecated in `v2.10.0` in favor of `semantic_version`.

Quickstart stale last tested: 2026-04-24

This example demonstrates defining a Pydantic model with a `PhoneNumber` field, which automatically validates the input. Note that `PhoneNumber` requires the `phonenumbers` optional dependency.

from pydantic import BaseModel, ValidationError
from pydantic_extra_types.phone_numbers import PhoneNumber

class Contact(BaseModel):
    name: str
    phone: PhoneNumber

try:
    # Valid phone number
    c = Contact(name='Alice', phone='+1 650-253-0000')
    print(c.phone.e164) # Outputs: +16502530000 (formatted by default as RFC3966 or E164, depending on version/config)

    # Invalid phone number
    Contact(name='Bob', phone='not-a-phone-number')
except ValidationError as e:
    print(f"Validation error: {e}")