Data types
State names and two-letter postal codes follow USPS notation. Street, city, and postal code come from publicly checkable non-residential locations; area codes support North American phone-format tests.
No real personal records
Names are synthetic, emails use a reserved example domain, and phones use test ranges. Generated records do not identify real residents.
Updates and corrections
Records are updated when public institutions move or postal rules change. Report a reproducible field combination through the contact page if you find a mismatch.
Data snapshot and version
The current static data version is 2026.08.13 and was last reviewed on August 13, 2026. The snapshot contains 170 public address samples across 23 countries and 160 address combinations across all 50 US states and the District of Columbia.
The version date records this site's content and sample review. It does not imply that every referenced organization published new data on that date.
How records are generated
- Select a country or US state from static regional records, keeping city, region code, postal code, and area code grouped.
- Select street, city, and postal code together from public non-residential location records; names remain synthetic test data.
- Use example.com for email. Only the US, UK, and Australia output officially reserved fictional phone ranges; other countries omit phone values.
- Check field shape and regional consistency only. The generator does not query USPS Delivery Point Validation or claim deliverability.
Limits and authoritative references
Cities and ZIP Codes may have many-to-many relationships, and area-code coverage can change. This data supports UI, API, and database testing, not shipping, identity, payment, tax, or emergency communications. When records differ, use the relevant authority's live result.
- USPS Publication 28 — Postal Addressing Standards (October 2024)
- USPS Publication 28 Appendix B — Two-Letter State Abbreviations
- USPS ZIP Code Lookup
- NANPA — Area Code Maps
- NANPA — 555 Line Numbers
- IANA — Reserved Example Domains
- U.S. Census Geocoder — address relationship audit
- Institute of Museum and Library Services — Public Libraries Survey FY 2022 outlet data
- Google libaddressinput — country field and format metadata
- Universal Postal Union — international addressing references
- OpenStreetMap contributors — geocoded public locations (ODbL)
- City of Los Angeles — public address listing
- NYC Government — City Hall mailing address
- City of Toronto — Toronto City Hall