Loading...

Incomplete: 123 Main Street (apartment building)

Complete: 123 Main Street, Apt 4B


Many validation APIs flag this as "valid but incomplete."


Incorrect Street Suffix


Wrong: 123 Main Strret (typo)

Wrong: 123 Main St. (period not needed)

Right: 123 Main St

Right: 123 Main Street


Transposed Fields


Wrong: Street: "New York", City: "123 Main Street"

Right: Street: "123 Main Street", City: "New York"


Validation User Experience


Do Not Over-validate


Rejecting technically valid but unusual addresses frustrates users:


  • Hyphenated house numbers (12-34) are valid in some areas
  • Very long street names exist and are valid
  • Names with apostrophes (O'Brien Street) are valid
  • Numbered street names (42nd Street) are valid

  • Suggest, Do Not Block


    When validation finds a potential issue, suggest a correction rather than blocking submission:


    "Did you mean 123 Main Street, New York, NY 10001?"

    [Accept Suggestion] [Use My Address]


    This approach catches real errors while letting users with unusual but valid addresses proceed.


    Tips for Developers


  • **Implement validation progressively** - Start with presence checks, add format checks, then add API validation
  • **Never mark an address as invalid just because your API cannot verify it** - API coverage is not 100%
  • **Cache validation results** - Do not re-validate an address that has not changed
  • **Show specific error messages** - "Invalid postal code" is more helpful than "Invalid address"
  • **Test validation with generated addresses** from multiple countries to ensure you are not too strict
  • Related Articles

    What Is a Fake Address Generator and How to Use OneUS Address Format Guide: How to Write American AddressesAddress Formats Around the World: A Developer Guide