You're viewing a free sample

Get the complete dataset — all rows and files — delivered instantly after checkout, with lifetime access to the latest version.

Secure checkout via Stripe
Instant download after payment
Lifetime access to the latest version
MIT License license

20% off

$49.90$39.92

one-time payment

Download sample · CSV Report an Issue

API Access

Access dataset files directly from scripts, code, or AI agents.

Browse dataset files

Dataset Files

Each file has a stable URL (r-link) that you can use directly in scripts, apps, or AI agents. These URLs are permanent and safe to hardcode.

/logistics/postal-codes-br/

├ .licensing-notes.md

https://datahub.io/logistics/postal-codes-br/_r/-/.licensing-notes.md

├ .migration-notes.md

https://datahub.io/logistics/postal-codes-br/_r/-/.migration-notes.md

├ ATTRIBUTION.txt

https://datahub.io/logistics/postal-codes-br/_r/-/ATTRIBUTION.txt

├ README.md

https://datahub.io/logistics/postal-codes-br/_r/-/README.md

└ datapackage.yaml

https://datahub.io/logistics/postal-codes-br/_r/-/datapackage.yaml

Key Files

Start with these files — they give you everything you need to understand and access the dataset.

datapackage.yaml— metadata & schema

https://datahub.io/logistics/postal-codes-br/_r/-/datapackage.yaml

README.md— documentation

https://datahub.io/logistics/postal-codes-br/_r/-/README.md

Typical Usage

1. Fetch datapackage.yaml to inspect schema and resources
2. Download data resources listed in datapackage.yaml
3. Read README.md for full context

Data Files

postal-codes-br-sample

Field	Type	Description	Constraints	Title
country_code	string	ISO 3166-1 alpha-2 country code — always BR	{ "pattern": "^BR$", "required": true }	Country Code
postal_code	string	Brazilian CEP, format NNNNN-NNN (full 8-digit code)	{ "pattern": "^\\d{5}-\\d{3}$", "required": true }	Postal Code
place_name	string	Bairro (neighborhood) — the CEP system's sub-municipal delivery unit		Place Name
admin_name1	string	State or Federal District name (Estado / Distrito Federal)		Administrative Name 1
admin_code1	string	ISO 3166-2:BR state code, BR- prefix stripped (e.g. SP, RJ, DF)		Administrative Code 1
admin_name2	string	Municipality name (Município)		Administrative Name 2
admin_code2	string	IBGE municipality code (7-digit)		Administrative Code 2
admin_name3	string	Bairro (neighborhood) — same value as place_name		Administrative Name 3
admin_code3	string	Reserved — no bairro-level code exists in any source		Administrative Code 3
latitude	number	Latitude coordinate (WGS84, decimal degrees) — not available for BR		Latitude
longitude	number	Longitude coordinate (WGS84, decimal degrees) — not available for BR		Longitude
accuracy	string	Coordinate accuracy tier — not available for BR		Accuracy
alternative_city_name	string	Full compound bairro name where the source assigns one CEP to a zone spanning two former neighborhoods (e.g. 'Jardim Monte Cristo/Parque Oziel'); place_name carries only the first component		Alternative City Name

Download

Download sample CSV

About

Total rows: ...
Format: CSV
Sources: SeuAliado/OpenCEP (MIT License) — primary bulk CEP data; Mendeley Data, "Códigos de CEP do Brasil por UF, CIDADE, BAIRRO E LOGRADOURO" by Ivan Zimmermann (CC BY 4.0) — secondary CEP data, consolidated for coverage; IBGE Localidades API — official state and municipality reference; kelvins/municipios-brasileiros (MIT License) — municipality dictionary
License: MIT License

About this dataset

Brazil (BR): migration notes

Internal record of the P5 migration. This is a dated record (2026-10-05) and is not shipped in the zip.

Issue: pc-28e.7.8 (open, deferred)
Producer: none written. The descriptor keeps pipeline: producer: custom with refresh disabled, and the data stays as harvested from the live zip in 09d7c89.
Parity: not run (no producer).

Why it stays on live data

173 live codes come only from a one-off ruacep.com.br scrape (rights reserved), which can't be rerun as a source.
Some live rows can't be traced to any source, and the committed builder doesn't reproduce live.

Decisions

Decision	By	Basis
Defer: stay on live data	User, 2026-10-03	Untraceable rows; builder doesn't reproduce live

Open questions

Revisit only with a rerunnable source for the scraped codes.

Provenance

Written 2026-10-05 from docs/parity/p5.md (batch sign-offs) and the bd notes on pc-28e.7.8.