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

$99.90$79.92

one-time payment

Download sample · CSV · 8.98 kB 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

├ README.md

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

└ datapackage.yml

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

Key Files

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

datapackage.yml— metadata & schema

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

README.md— documentation

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

Typical Usage

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

Data Files

Postal Codes Data Resource for Brazil, BR

Field	Description	Title
country_code	ISO 3166-1 alpha-2 code for the country.	Country Code
postal_code	Postal code for the location.	Postal Code
place_name	Name of the city, town, or place.	Place Name
admin_name1	Primary administrative division (e.g., state, region).	Administrative Name 1
admin_code1	Code for the primary administrative division.	Administrative Code 1
admin_name2	Secondary administrative division (e.g., county, district).	Administrative Name 2
admin_code2	Code for the secondary administrative division.	Administrative Code 2
admin_name3	Tertiary administrative division (e.g., municipality, borough).	Administrative Name 3
admin_code3	Code for the tertiary administrative division.	Administrative Code 3
latitude	Latitude coordinate of the place.	Latitude
longitude	Longitude coordinate of the place.	Longitude
accuracy	Accuracy level of the latitude and longitude coordinates.	Accuracy
alternative_city_name	Alternative name(s) for the city or place.	Alternative City Name

Download

Download sample CSV

About

Last updated: 7 November 2024
Total rows: ...
Format: CSV
File size: 8.98 kB
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

Postal Codes Dataset for Brazil (BR)

This dataset contains Brazilian CEP postal codes — 1,233,231 rows covering all 27 states and the Federal District, across 5,570 municipalities.

Granularity note: postal_code is the full 8-digit CEP (NNNNN-NNN), assigned at street-segment / delivery-zone level. place_name is bairro (neighborhood), the CEP system's own sub-municipal unit — a postal delivery convention, not a formally bounded IBGE administrative district. The primary key is (postal_code, place_name), never postal_code alone: one CEP legitimately carries several bairro rows in some cities.

Compound bairro names: 209 rows have a source CEP assigned to a zone spanning two named neighborhoods (e.g. "Jardim Monte Cristo/Parque Oziel"). place_name carries the first component only; the full compound name is preserved in alternative_city_name.

Note: This dataset is a sample containing the first 100 rows. If you need access to the complete dataset, please contact our sales team for more information: datahub@datopian.com

Data Sources

Postal codes are consolidated from two sources for coverage: SeuAliado/OpenCEP (MIT License), the primary bulk CEP source, and Mendeley Data's "Códigos de CEP do Brasil por UF, CIDADE, BAIRRO E LOGRADOURO" by Ivan Zimmermann (CC BY 4.0). State and municipality reference data comes from IBGE (Instituto Brasileiro de Geografia e Estatística), the Brazilian federal statistics agency, and kelvins/municipios-brasileiros (MIT License). admin_code1 is the ISO 3166-2:BR state code; admin_code2 is the IBGE municipality code.

A small subset of rows (roughly 7,000 of 1,233,231) was originally sourced via a community site whose terms publish no explicit data-reuse licence and could not be cleanly isolated from the consolidated data during rebuild — contact datahub@datopian.com before relying on this dataset under a licence that requires clean chain-of-title for every row.

Usage

The dataset files are available in CSV format and can be accessed and downloaded using the links provided in the datapackage.yml.

postal_code and admin_code2 carry significant leading zeros / all-digit strings and must be read as text (dtype=str), or use the schema in the packaged datapackage.json.

For access to the full dataset or other inquiries, please contact our sales team at datahub@datopian.com