About

Software testing, form validation, and database seeding require structurally valid postal addresses that do not correspond to real individuals. Using production addresses violates privacy regulations. Using obviously fake data (e.g., "123 Test St") fails format validation and misses edge cases like multi-word city names or five-digit ZIP codes that must align with their state. This generator produces fictitious US addresses assembled from real naming conventions: USPS-standard street suffixes (St, Blvd, Ct), directional prefixes (N, SW), and ZIP code prefixes mapped to correct states per USPS Publication 65.

Each address is a random combination. No generated address is guaranteed to be non-existent, but the combinatorial space (street number × street name × suffix × city × unit) makes collisions with real addresses statistically negligible. Do not use generated addresses for fraudulent purposes. This tool is intended for development, UI mockups, and testing pipelines only.

Formulas

Each address is assembled from independent random selections across five components. The total combinatorial space determines collision probability.

Address = StreetNum + Direction + StreetName + Suffix + Unit

The number of unique addresses per city is:

N = S_num × D × S_name × X × U

Where S_num = 19999 possible street numbers, D = 9 directional options (including none), S_name = 80 street names in the dataset, X = 18 street suffixes, and U = 300 unit numbers (including none). This yields approximately 7.8 × 10⁹ unique street lines per city.

ZIP code generation follows USPS prefix mapping:

ZIP = pad(randInt(prefix_min × 100, prefix_max × 100 + 99), 5)

Where prefix_min and prefix_max are the USPS-assigned three-digit prefix boundaries for a given state, and pad zero-pads the result to 5 digits.

Reference Data

State	Abbreviation	ZIP Prefix Range	Capital City	USPS Region
Alabama	AL	350 - 369	Montgomery	South
Alaska	AK	995 - 999	Juneau	West
Arizona	AZ	850 - 865	Phoenix	West
California	CA	900 - 961	Sacramento	West
Colorado	CO	800 - 816	Denver	West
Connecticut	CT	060 - 069	Hartford	Northeast
Florida	FL	320 - 349	Tallahassee	South
Georgia	GA	300 - 319	Atlanta	South
Illinois	IL	600 - 629	Springfield	Midwest
Indiana	IN	460 - 479	Indianapolis	Midwest
Massachusetts	MA	010 - 027	Boston	Northeast
Michigan	MI	480 - 499	Lansing	Midwest
Minnesota	MN	550 - 567	Saint Paul	Midwest
New York	NY	100 - 149	Albany	Northeast
North Carolina	NC	270 - 289	Raleigh	South
Ohio	OH	430 - 459	Columbus	Midwest
Oregon	OR	970 - 979	Salem	West
Pennsylvania	PA	150 - 196	Harrisburg	Northeast
Texas	TX	750 - 799	Austin	South
Virginia	VA	220 - 246	Richmond	South
Washington	WA	980 - 994	Olympia	West

Frequently Asked Questions

Addresses are assembled from random combinations of real naming patterns. The combinatorial space exceeds 7.8 × 10⁹ per city, making collisions with real addresses statistically improbable but not impossible. Do not use these for any purpose that assumes non-existence of the address.

Each state is assigned a three-digit ZIP prefix range per USPS Publication 65. For example, Texas uses prefixes 750-799. The generator produces a five-digit ZIP within the correct prefix range for the selected state, ensuring the ZIP would pass basic format and state-alignment validation.

Yes, that is the primary use case. Generated addresses conform to USPS formatting: numeric street number, optional directional prefix (N, S, E, W, NE, NW, SE, SW), street name, standard suffix (St, Ave, Blvd, etc.), optional unit line (Apt, Suite, Unit), city, two-letter state abbreviation, and five-digit ZIP. They will pass regex-based address validators.

Approximately 30% of generated addresses include a secondary unit designator (Apt, Suite, Unit, or # followed by a number). This reflects real-world distribution where multi-unit dwellings are common, and ensures your form testing covers the secondary address line field.

You can generate addresses in three formats: Standard (multi-line USPS format), Single Line (comma-separated, suitable for CSV), and JSON (key-value pairs for direct use in API testing or database seeding). All formats are copyable to clipboard.

Yes. When you select a specific state, both the city names and ZIP codes are constrained to that state's data. Cities are drawn from real city names within that state, and ZIP prefixes match USPS assignments. Selecting "Any State" draws randomly from all 50 states.