About

Generating test addresses by hand leads to implausible data: nonexistent ZIP codes, streets that don't match boroughs, or formatting that fails USPS validation. This tool produces addresses that follow real New York City geographic constraints. Every generated street name exists in the specified borough. Every ZIP code (10001 - 11697) maps correctly to its borough. Street numbers fall within realistic ranges for the street type. This matters for QA testing, form validation, database seeding, and UI mockups where obviously fake data undermines credibility.

The generator covers all 5 boroughs: Manhattan, Brooklyn, Queens, The Bronx, and Staten Island. Apartment/unit numbers follow standard USPS secondary designator formats (Apt, Suite, Floor, Unit). Phone numbers use valid NYC area codes (212, 718, 646, 917, 347, 929). Note: these are structurally valid addresses for testing purposes. They are not guaranteed to correspond to real occupied properties. Do not use generated data for any fraudulent or deceptive purpose.

Formulas

Address generation follows a deterministic structure with random selection at each layer. The output conforms to USPS Publication 28 formatting standards.

Address = StreetNumber + StreetName + Unit + Borough , NY + ZIP

Where:

StreetNumber ∈ Z⁺, drawn uniformly from [1, MaxRange_borough] using crypto.getRandomValues. Manhattan caps at 999; Queens extends to 25000 reflecting hyphenated addressing (e.g., 87-12).

StreetName is selected uniformly from a borough-specific lookup table of real street names. Each borough maintains its own list to prevent geographic mismatches (e.g., "Ocean Parkway" only appears in Brooklyn, not Manhattan).

ZIP is selected from the borough's valid ZIP code set. For Manhattan: 10001 - 10282. For Brooklyn: 11201 - 11256.

Unit is optionally appended with probability p = 0.4. Format: Apt + UnitID, where UnitID follows patterns like 3A, 12F, or plain numerics 101 - 2505.

Phone number structure: (AreaCode) Exchange-Subscriber, where Exchange ∈ [200, 999] and Subscriber ∈ [0000, 9999]. Exchange avoids 555 (reserved) and 911/411 (service codes).

Reference Data

Borough	Population (2020)	Area (mi²)	ZIP Code Range	County Name	Common Area Codes	Avg. Street Number Range
Manhattan	1,694,251	22.83	10001 - 10282	New York	212, 646, 332	1 - 999
Brooklyn	2,736,074	69.5	11201 - 11256	Kings	718, 347, 929	1 - 9999
Queens	2,405,464	108.53	11004 - 11697	Queens	718, 347, 929	1 - 25000
The Bronx	1,472,654	42.1	10451 - 10475	Bronx	718, 347, 929	1 - 5000
Staten Island	495,747	58.37	10301 - 10314	Richmond	718, 347, 929	1 - 9999
NYC Area Codes Detail
212		Original Manhattan code, established 1947. Premium/legacy.
718		Outer boroughs (Brooklyn, Queens, Bronx, Staten Island), established 1984.
646		Manhattan overlay, established 1999.
917		Citywide overlay, primarily cell phones, established 1992.
347		Outer boroughs overlay, established 1999.
929		Outer boroughs overlay, established 2011.
USPS Secondary Unit Designators
Apt		Apartment - most common residential designator in NYC.
Suite / Ste		Typically commercial or high-end residential.
Floor / Fl		Entire floor units, common in Manhattan office buildings.
Unit		Generic designator, used in condos and co-ops.
# (Number sign)		USPS-accepted catch-all when designator type is unknown.

Frequently Asked Questions

The street names and ZIP codes are real and correctly mapped to their boroughs. However, the street numbers are randomly generated, so the full address may or may not correspond to an actual building. The combination is structurally valid per USPS formatting but not verified against a property database. Use them for testing, not for mailing.

Queens uses a unique hyphenated addressing system established in the 1920s by the Topographical Bureau. The first part indicates the nearest cross street, and the second part is the building's sequential number on its block. For example, 87-12 means the building is on or near 87th cross street, number 12. The generator replicates this format for Queens addresses when the street type warrants it.

The generator avoids the 555-0100 through 555-0199 range (NANPA fictional block) and service codes like 911 and 411. Generated numbers use valid NYC area codes (212, 718, 646, 917, 347, 929) with random exchange and subscriber digits. These could theoretically belong to real people. For guaranteed safe test numbers, use the NANPA reserved range: (212) 555-0100 through (212) 555-0199.

Selection is weighted proportionally to the 2020 Census population of each borough. Brooklyn (2.74M) has approximately a 31% chance, Queens (2.41M) about 27%, Manhattan (1.69M) about 19%, The Bronx (1.47M) about 17%, and Staten Island (0.50M) about 6%. This produces a distribution that mirrors where NYC residents actually live.

Yes. Each borough has a hardcoded set of real USPS ZIP codes. Manhattan uses 10001-10282, Brooklyn uses 11201-11256, Queens uses 11004-11697, The Bronx uses 10451-10475, and Staten Island uses 10301-10314. The generator never cross-contaminates ZIP codes between boroughs.

The batch limit is 50 addresses per generation. This covers most testing scenarios (form testing, database seeding, spreadsheet population) without creating an unwieldy output. For larger datasets, generate multiple batches and use the export function to accumulate results.

Apartment designators follow common NYC patterns: floor-letter combinations (3A, 12F), pure numeric (101, 2505), and high-rise formats (PH for penthouse suites). The probability of an address receiving a unit number is set at 40%, reflecting that many NYC addresses are multi-unit residential buildings. Manhattan addresses receive units more frequently than Staten Island addresses in practice, and the generator accounts for this.