Brazil address generator

Random Brazil addresses for software testing. Every CEP is taken from the same dataset record as its city and state, and the address is laid out the way Brazil writes it.

A Dataset-matched
3,501 cities
27 states
Real CEPs

Country

State

City

Options

Always include an apartment or unit Never include a unit Add placeholder postcodes where none are linked to places Postal label capitals

Rodovia Dom Pedro II, 522 Tubarão-SC 88700-000 Brazil

City, state and CEP: one GeoNames record
Street name, number: synthetic

Synthetic test data: not a verified or deliverable address.

Street: Rodovia Dom Pedro II, 522
City: Tubarão
State: SC
CEP: 88700-000 From datasetThis postcode comes from the same dataset record as the locality and region.
Country: Brazil (BR)
Coordinates: -28.493, -49.036 Approximate centre of the locality, not the building

ALocality, region and postcode come from one dataset recordSeed page-BRHow coverage levels work

How addresses are written in Brazil

Layout from Google’s address metadata (libaddressinput), the format data Chrome and Android use for address forms.

[Organisation] [Recipient name] [Street address] [Neighborhood] [City]-[State] [CEP]

Required fields: Street address, state, city and CEP
CEP: Examples: 40301-110, 70002-900
Pattern: \d{5}-?\d{3}
States: 27 in the dataset
Capitals: Mail labels conventionally capitalise the city and state
Script: Latin
Calling code: +55
Official lookup: Postcode finder

Map of the 3501 localities in Brazil used by the generator — Each dot is a city the generator can use.

About the data for Brazil

ADataset-matched. Each locality, region and postcode is taken from the same GeoNames postal codes record.

Localities: 3,501 · GeoNames postal codes
Postcodes: Every postcode comes from the dataset record of its locality.
Names: pt_BR + Brazilian Portuguese (common surnames) (country-specific list)
Streets: Synthetic names built from common local street words. They are not taken from real maps.

GeoNames supplies one main CEP per municipality (ending in -000). Real street-level CEPs are more specific.

Sources, licences and method

Sample Brazil addresses

Eight addresses generated with a fixed seed. The city, state and CEP are real; street names and numbers are not.

Formatted address	CEP
Rua Washington Nascimento, 176, Sala 37 Montanhas-RN 59198-000	59198-000
Alameda Amazonas, 132 Belo Campo-BA 45160-000	45160-000
Rua Rui Barbosa, 200 Glória d'Oeste-MT 78293-000	78293-000
Rodovia Duque de Caxias, 10, Sala 17 Fortuna de Minas-MG 35760-000	35760-000
Alameda Santos Dumont, 1346 São Bento do Una-PE 55370-000	55370-000
Rua dos Girassóis, 2784 José Raydan-MG 39775-000	39775-000
Avenida dos Girassóis, 1051, Apto 1210 Natividade da Serra-SP 12180-000	12180-000
Alameda Barão do Rio Branco, 1422 Junco do Seridó-PB 58640-000	58640-000

States of Brazil

Pick one in the generator above to keep every address inside it. Postcode prefixes are from Google’s address metadata.

State	Abbreviation	Localities	CEP prefix
Acre	AC	14	699
Alagoas	AL	64	57
Amapá	AP	10	689
Amazonas	AM	39	690–692, 694–698
Bahia	BA	263	40–48
Ceará	CE	117	60–63
Distrito Federal	DF	12	70, 71, 720–727, 730–736
Espírito Santo	ES	49	29
Goiás	GO	153	728, 729, 737–739, 74–76
Maranhão	MA	137	65
Mato Grosso	MT	80	780–788
Mato Grosso do Sul	MS	49	79
Minas Gerais	MG	540	3
Pará	PA	91	66, 67, 680–688
Paraíba	PB	141	58
Paraná	PR	253	80–87
Pernambuco	PE	117	50–56
Piauí	PI	140	64
Rio de Janeiro	RJ	57	20–28
Rio Grande do Norte	RN	105	59
Rio Grande do Sul	RS	296	9
Rondônia	RO	33	768, 769, 789
Roraima	RR	10	693
Santa Catarina	SC	186	88, 89
São Paulo	SP	409	01–09, 11–19
Sergipe	SE	48	49
Tocantins	TO	88	77

Brazil address generator

How addresses are written in Brazil

About the data for Brazil

Brazil address generators by state

Sample Brazil addresses

States of Brazil

Neighbouring countries