Brazil Address Generator

How a Brazilian address is written

Brazil follows the Correios layout, read from the smallest unit to the largest. The first line holds the logradouro (street type and name), a comma and the building number: Rua das Palmeiras, 482. The complemento follows, either on the same line after a dash or on its own line: Apto 1203, Bloco B, Apto 41, Casa 3, Sala 905 or Fundos (rear house). Next comes the bairro (neighbourhood), then the city and the state abbreviation separated by a dash or slash (Curitiba – PR), and finally the CEP.

Street types are usually abbreviated on labels: R. (Rua), Av. (Avenida), Tv. (Travessa), Al. (Alameda), Pç. (Praça), Rod. (Rodovia) and Estr. (Estrada). A property without a number is written s/n (sem número), so a number field that only accepts digits will reject real addresses.

CEP structure

The CEP (Código de Endereçamento Postal) has eight digits, written as five, a hyphen and three: 01310-100. The first digit is the postal region: 0 for Greater São Paulo, 1 for the rest of São Paulo state, 2 for Rio de Janeiro and Espírito Santo, 3 for Minas Gerais, 4 for Bahia and Sergipe, 5 for Pernambuco, Alagoas, Paraíba and Rio Grande do Norte, 6 for the North and part of the Northeast, 7 for the Federal District and the Centre-West, 8 for Paraná and Santa Catarina and 9 for Rio Grande do Sul. The following digits narrow it down to sub-region, sector and finally the street or section of a street.

Large cities have a CEP per street or even per side of a long avenue. Many small towns use a single general CEP ending in -000 for the whole municipality. The generator picks a range that matches the chosen city (São Paulo capital starts with 01–05, Rio de Janeiro with 20–23, Porto Alegre with 90–91), but the exact code is random and may not appear in the Correios database.

States and the UF field

Brazil has 26 states plus the Distrito Federal, each with a two-letter UF code (SP, RJ, MG, DF …). The UF is always written in capitals and is mandatory on mail. In forms, offer a select with all 27 units and store the code separately from the city name: several cities share names across states (there is a Bom Jesus in more than one state), so city alone is not unique.

Validation and testing tips

• Accept the CEP with or without the hyphen (^\d{5}-?\d{3}$) and store the eight digits as text. Codes in Greater São Paulo begin with 0, and an integer column silently drops it.
• Many checkouts autofill street, bairro and city from the CEP. Test what happens when the lookup returns nothing: generated CEPs are format-correct but not guaranteed to exist, which is exactly the case you want to cover.
• Keep accents in city and bairro names (São Luís, Goiânia, Vitória) and make sure exports to CSV keep UTF-8.
• Allow letters in the number field (s/n, 120A) and a generous length for the complemento.

What the generator does not create

Brazilian checkouts often ask for a CPF or CNPJ tax number. This tool deliberately does not generate them: they identify real people and companies. Use the test values your payment provider documents for its sandbox instead. All street names here are built from generic words and random numbers, so any match with a real address is coincidental.

States of Brazil

The generator uses the 27 first-level states below, with the codes used in addresses. Cities are picked from 18 places spread across the country, each with postcodes from its own range.

Example Brazil test addresses

Validation pattern used for the CEP: ^\d{5}-\d{3}$. It checks the format only — whether a code is actually in use is known only to the postal operator.

Phone numbers in Brazil test data

Brazilian numbers are written +55 with a two-digit area code (DDD), for example +55 (11) 9XXXX-XXXX for a São Paulo mobile. We know of no officially reserved fictional range for Brazil, so the generator leaves the phone field blank instead of inventing numbers that could belong to someone.

Sources

• Correios – Busca CEP
• Wikipedia – Código de Endereçamento Postal
• ISO 3166-2:BR (Wikipedia)

Postcode ranges, region lists and address conventions checked against these sources in October 2026. Street names in the generator are synthetic.

Other countries: United StatesUnited KingdomCanadaAustraliaIndiaGermanyFranceSpainItalyNetherlandsMexicoJapanPhilippinesPakistanNigeriaSouth AfricaTurkeyIndonesiaUnited Arab Emirates