How an address is written in Brazil

The order the lines go in

The parts are named rather than filled in: Spaw does not know an address in Brazil and will not invent one. This block is produced by the same function that rewrites a real address, so the line order, the capitals Brazil asks for and any text its operator prints on every envelope are the checker's own behaviour rather than a second description of it.

Organisation
Street name 12
Flat or unit
Neighborhood
TOWN OR CITY-STATE
Postal code

No recipient line: nothing in the response is about a person, so the name the envelope carries is not part of what is checked.

In Brazil the house number follows the street name, and that is the side it is written back on when the checker rewrites an address. The postal code is written after the town.

Can Spaw tell whether an address in Brazil exists?

Partly. IBGE's 2022 census address file (CNEFE) lists 60,567,115 addresses in all 27 states of Brazil (oldest file 17 May 2024), but not every address in Brazil: a partial address register confirms what it holds and denies nothing. An address that is listed answers exists: true; one that is not answers null — not evaluated, never no.

A postcode directory answers a different question. The postal code is confirmed separately by GeoNames' postal code list, which does not list every code, so one it does not hold is not flagged.

Further reading: How to read an address-existence answer and How an open register locates a building.

Check an address in Brazil

The same lookup the API runs, with Brazil already selected.

The postal code

Postal codes in Brazil are checked against the pattern below rather than a description of it, because the shape is too particular to summarise without losing a case.

pattern \d{5}-?\d{3}

What Brazil calls an address that is not a front door

A PO box, a private mailbox and the other kinds of delivery point below are told apart by the words written on the address, never by a list of whose box is whose. The rows marked as the operator's own words are taken from the addressing guide of the postal operator in Brazil; the others are international spellings, not the operator's own. All of them are what the checker reads, and because an entry is carried for Brazil, an address here with none of them answers street.

APARTAMENTO, APTO, APT, AP, CASA, SALA, LOJA, BLOCO, BL, ANDAR, CONJUNTO, CONJ, TORRE look like box words in Brazil but name a flat or suite. They classify nothing; they only tell the parser where the unit is.

The state codes

27 codes, which is what lets a written address be split at all — and the state written out in full is folded onto its code, so the two spellings are read as the same place.

What can be checked for an address in Brazil

Read from the datasets this server holds right now, not written into the page. For most countries the answer is the written form and the postcode shape and nothing beyond them — in particular not the row people assume is always there.

Null means not evaluated, never no.

Other countries

• Barbados
• Belgium
• Bahrain
• St. Barthélemy
• Canada
• Switzerland
• China
• Colombia
• Check any address
• Every dataset behind the checker

Sources

• Google's Address Data Service · address-formats 2026-09-05© Google LLC, CC BY 4.0 (Google Address Data Service); initial import via commerceguys/addressing (MIT)
• The postal operators' addressing guides · address-rules 2026-09-17
• IBGE's 2022 census address file (CNEFE) · br-cnefe-2022 2024-05-17IBGE, Cadastro Nacional de Endereços para Fins Estatísticos (CNEFE), Censo Demográfico 2022 — dados públicos, fonte citada
• GeoNames' postal code list · geonames-postal-codes 2026-10-31Postal codes, places and centroids from GeoNames (geonames.org), CC BY 4.0.

Data synced on 2026-10-31: the newest version among the datasets listed above.