A Valid Brazilian Address Example
A valid Brazilian address example has a street-and-number line, a neighbourhood line, and a last line carrying the city, the two-letter state abbreviation, and the eight-digit CEP — for example "Rua Example, 123" on the first line, "Bela Vista" on the next, and "São Paulo SP 01310-100" on the last. A CEP is always eight digits, printed as five digits, a hyphen, then three digits, a fixed shape UPU S42 records as distinct from a seven-character Eircode or a five-digit Postleitzahl.
Fake Addresses resolves every generated Brazilian CEP to a real state and a real municipality by testing the CEP's own point against a real administrative boundary, and states that ceiling plainly rather than implying street-level precision the underlying data does not have. The free postal-code source behind Brazil's coherence is published at municipality granularity only: it carries one representative CEP per municipality rather than the full run of codes a real eight-digit CEP can take within a single city block. That is a coarser ceiling than a country like Germany or France, where the free postal code itself already narrows to a small area inside one city, and Fake Addresses is explicit about it rather than letting a single example CEP imply a precision the source cannot back up.
A QA engineer testing a Brazilian shipping or billing form should treat the municipality shown on a generated record as the trustworthy field, not the specific street or CEP suffix. The street-and-number line is fully synthesised, and the CEP itself, while a real, valid code for that municipality, does not carry the neighbourhood-level precision a real eight-digit CEP can have inside a large city.
Brazilian CEP Format and Examples
Fake Addresses generates a Brazilian CEP that is always eight digits, printed as five digits, a hyphen, then three digits, and resolved to one real municipality per code:
| CEP | State | Municipality |
|---|---|---|
| 01310-100 | São Paulo (SP) | São Paulo |
| 20040-020 | Rio de Janeiro (RJ) | Rio de Janeiro |
| 30130-000 | Minas Gerais (MG) | Belo Horizonte |
| 40010-000 | Bahia (BA) | Salvador |
How Brazilian Address Format Compares to the United States and India
Fake Addresses compares Brazil's municipality-level CEP ceiling with the United States and India, two countries whose own free postal-code sources stop at a different administrative level:
| Country | Free-source coherence ceiling | Postal-code position |
|---|---|---|
| Brazil | Municipality — one CEP resolved per municipality, not per street or neighbourhood | End of the last line |
| United States | Street and delivery route — a ZIP+4 narrows to a specific block, per USPS Publication 28 | End of the last line |
| India | State only — a PIN code resolves to a state, with the district name carried but not independently verified | End of the last line |
Synthetic Test Data Generation for Brazilian Test Addresses
Synthetic test data generation for Brazil has to communicate a municipality-level ceiling honestly, not just a street-level gap like most of the other countries in this build, because a bare eight-digit CEP looks identical whether it resolves to a city block or an entire municipality. Fake Addresses treats that distinction as worth stating outright, because a CEP that looks like a normal eight-digit code can otherwise read as more precise than the free source behind it actually is.
Fake Addresses states its Brazilian coherence level plainly on the random Brazil address generator: the state and municipality are both real and point-in-polygon verified from the CEP's own coordinates, while the neighbourhood, street and house number are all synthesised. A QA engineer testing a Brazilian delivery or billing form should treat the municipality as the one administrative fact a real validation service ought to confirm, and every field below it as a placeholder.
Every generated Brazilian record stays non-deliverable by construction for the same reason as every other country this product ships, regardless of the coarser municipality ceiling described above. The street-and-number line and the neighbourhood name are never drawn from a real registry, so a generated Brazilian record cannot coincide with a real delivery point, and a Brazilian test fixture built from this data carries no risk of resolving to somebody's real address, whether it is committed to a public repository or run against a live validation endpoint.
Frequently asked questions
Why does Fake Addresses resolve a Brazilian CEP to a municipality instead of a street?
The free postal-code source behind Brazil's coherence publishes one representative CEP per municipality rather than the full range of codes a real eight-digit CEP can take inside a single city. Fake Addresses states that municipality-level ceiling directly rather than letting an eight-digit CEP imply street-level precision the underlying data does not have.
Is a Fake Addresses Brazilian street address real?
No. Fake Addresses synthesises the street-and-number line and the neighbourhood name on every generated Brazilian record, because the free source behind the CEP and municipality only reaches municipality level. The state, municipality and CEP shown are real and point-in-polygon verified; the rest of the address is not.
How does a Brazilian CEP compare to an Indian PIN code?
Both are purely numeric, area-resolving postal codes rather than per-address codes, but the administrative level each one honestly resolves to is different: Fake Addresses verifies a Brazilian CEP down to the municipality and an Indian PIN code down to the state only. Neither claims the street-level precision a US ZIP+4 or a German postal code can reach.
Sources
- Universal Postal Union — The Universal Postal Union runs an addressing-solutions programme, including international addressing standards and assistance to member countries whose addresses do not follow a US or UK-style format.
- United States Postal Service — Postal Explorer — USPS Publication 28 defines a "standardized address" as one using official USPS abbreviations, and a "complete address" as one containing everything needed to match the ZIP+4 and City State files.