Generate Random Brazilian Addresses with Valid CEP Codes
Brazil uses a postal code system called CEP (Código de Endereçamento Postal), managed by Correios, the Brazilian postal service. A CEP is eight digits formatted as XXXXX-XXX — for example, 01310-100 for Avenida Paulista in São Paulo, or 20040-020 for Avenida Rio Branco in Rio de Janeiro. Brazil is the largest country in South America with 26 states and the Federal District (Brasília), each identified by a two-letter abbreviation. Addresses typically include a street type prefix in Portuguese (Rua, Avenida, Travessa, Alameda, Praça) followed by the street name.
Developers building applications for the Brazilian market face a uniquely complex environment: CEP validation via the Correios ViaCEP API is a common integration requirement, addresses must handle Portuguese characters including ã, ç, and ê, and Brazil's 26 states create significant diversity in both address patterns and tax rules (each state has its own ICMS tax rate). Our Brazil address generator produces addresses across all states — from Amazonas in the north to Rio Grande do Sul in the south — with correctly formatted CEP codes.
How to Use the Brazil Address Generator
Select Brazil from the country dropdown and choose the number of addresses you need. The generator returns complete Brazilian addresses including a street type and name in Portuguese, a house number (número), a neighborhood (bairro), a city (cidade), a state abbreviation (UF), and a correctly formatted eight-digit CEP code.
Copy or export your results immediately. The CEP codes follow the correct XXXXX-XXX format and are matched to plausible state and city combinations, so they will pass basic format validation in Brazilian address forms and ViaCEP-based lookup integrations used throughout Brazilian e-commerce.
Why Teams Building for Brazil Need Fake Address Data
Brazilian e-commerce developers use generated addresses to test Correios, Jadlog, and Mercado Envios shipping integrations, validate CEP lookup API calls, and verify that ICMS tax calculation logic correctly identifies each state — São Paulo (SP) and Rio de Janeiro (RJ) have different ICMS rates than Minas Gerais (MG) or Bahia (BA). Fintech developers building PIX payment flows or KYC onboarding for the Brazilian market use fake addresses to populate test data without involving real CPF or address records. QA engineers use them to test that address forms accept Portuguese special characters and handle the complemento (apartment or floor) field correctly. Designers building Brazilian-market apps use generated addresses alongside our name generator and our username generator to create authentic Brazilian test personas. Data teams use address batches to test geolocation services across Brazil's vast geographic spread.
Understanding the Brazilian Address Format and CEP System
A standard Brazilian address is written as: street type and name followed by the house number and optional complement (e.g., Rua das Flores, 123, Apto 45), then the bairro (neighborhood) on the next line, then the city name, state abbreviation (UF), and CEP on the final line — for example: São Paulo, SP, 01310-100. The 26 state abbreviations (UF codes) include SP (São Paulo), RJ (Rio de Janeiro), MG (Minas Gerais), BA (Bahia), RS (Rio Grande do Sul), PR (Paraná), PE (Pernambuco), CE (Ceará), PA (Pará), and AM (Amazonas). CEP codes begin with regional digits: 01000-001 to 09999-999 are in São Paulo city, 20000-000 to 28999-999 cover Rio de Janeiro state, and 69000-000 to 69999-999 cover Amazonas state.
Frequently Asked Questions
What is a CEP and how is it formatted?
CEP stands for Código de Endereçamento Postal — Brazil's postal code system operated by Correios. A CEP is always eight digits formatted as XXXXX-XXX, with a hyphen separating the fifth and sixth digits. For example, 01310-100 is the CEP for Avenida Paulista in São Paulo. The first five digits indicate the delivery region and the last three narrow it to a specific street segment or building.
How many states does Brazil have?
Brazil has 26 states plus the Distrito Federal (Brasília, DF). Each state has a two-letter abbreviation called the UF (Unidade Federativa) code. The most populous states are São Paulo (SP), Minas Gerais (MG), Rio de Janeiro (RJ), Bahia (BA), and Rio Grande do Sul (RS).
What are common Brazilian street type prefixes?
Brazilian addresses use Portuguese street type prefixes: Rua (street), Avenida (avenue), Travessa (lane or alley), Alameda (tree-lined street), Praça (square), Rodovia (highway), Estrada (road), and Largo (small square). The type always precedes the street name, as in Avenida Atlântica or Rua Oscar Freire.
What is the complemento field in a Brazilian address?
The complemento (complement) field in a Brazilian address specifies additional location detail within a building or compound — such as an apartment number (Apto 12), a floor (3° andar), a block (Bloco B), or a house designation (Casa 2). It is an optional but commonly used field in Brazilian address forms.
Can I generate Brazilian addresses for a specific state like São Paulo or Minas Gerais?
Yes. The generator lets you filter by Brazilian state (UF) so you can produce addresses exclusively from São Paulo, Rio de Janeiro, Minas Gerais, or any of the other 24 states and the Distrito Federal — useful when testing state-specific tax logic or regional shipping rules.