# GenAddr

> GenAddr is a free synthetic address and test data generator for QA, software testing, form validation, demos, database seeding, and model training data. It produces realistic, geographically consistent addresses including postal codes and phone numbers for 20+ countries, with extensive support for US address formats, state abbreviations, capitals, tax-free states, and validation edge cases.

GenAddr helps developers and QA teams generate high-quality non-production data without using real customer information. The site is fully internationalized with support for English, Chinese, Indonesian, Arabic, and other languages.

## Main Tools

- [Homepage](https://genaddr.com/): Primary interactive generator for addresses across multiple countries and formats.
- [Directory](https://genaddr.com/en/directory): Comprehensive listing of all country, region, state, and city-specific address generators.
- [US Address Generator](https://genaddr.com/en/us-address-generator): Advanced US-focused tool with full state, city, ZIP, and phone support.
- [Random Address Generator](https://genaddr.com/en/random-address-generator): Quick generation of random synthetic addresses.

## Documentation & Guides

- [Blog](https://genaddr.com/en/blog): Practical guides covering US address formats, tax-free states (Delaware, Oregon, Alaska, etc.), test data best practices, form validation, and synthetic data strategies.
- [US Tax-Free States](https://genaddr.com/en/blog/us-tax-free-states): Detailed comparison of states without general sales tax for digital goods and billing address testing.
- [US State Abbreviations & Capitals](https://genaddr.com/en/blog/us-state-abbreviations-capitals): Reference for state codes, capitals, and test city selection in address forms and fixtures.
- [API Documentation](https://genaddr.com/en/api): REST API for programmatic address generation with export to JSON, CSV, and SQL.

## Resources

- [Sitemap](https://genaddr.com/sitemap.xml): Complete site index including all localized pages.
- [OpenAPI Schema](https://genaddr.com/openapi.json): Machine-readable API specification.
- [Privacy Policy](https://genaddr.com/en/privacy)
- [Terms of Service](https://genaddr.com/en/terms)

## Usage Guidelines

All content and generated addresses are intended exclusively for software testing, QA automation, form development, demonstrations, database seeding, and training data. Do not use GenAddr for identity impersonation, fraud, real shipping, payments, account verification, or any production or deceptive activities.

## Optional

- [Indonesian (id) Blog](https://genaddr.com/id/blog): Localized version of guides in Bahasa Indonesia.
- [Arabic (ar) Blog](https://genaddr.com/ar/blog): Localized version of guides in Arabic (RTL supported).
- Additional localized generators and pages are available via language prefixes such as /zh/, /id/, /ar/, etc.