Part of a Data Solution
- Explore →
Postal Codes Solution
Every worldwide postal-code dataset in one bundle — the ultimate global reference for precise postal codes.
Premium
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
API Access
Access dataset files directly from scripts, code, or AI agents.
Browse dataset files
API Access
Access dataset files directly from scripts, code, or AI agents.
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.
Start with these files — they give you everything you need to understand and access the dataset.
- 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 CSVAbout
- Last updated
- 12 October 2026
- Total rows
- 100
- Format
- CSV
- File size
- 7.47 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, covering all states and the Federal District and their municipalities.
Column definitions, row count, size and last-updated date are in datapackage.yaml.
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: some 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.
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 (data.mendeley.com, CC BY 4.0). State and
municipality reference data comes from IBGE (Instituto Brasileiro de Geografia e
Estatística, Localidades API), 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.
Changes made to the source data: the postal sources are consolidated into one dataset;
admin_code1 is the ISO 3166-2:BR state code and admin_code2 is the IBGE municipality
code.
Not endorsed by, or affiliated with, the owners of these sources.
Usage
The dataset files are available in CSV format and can be accessed and downloaded using
the links provided in datapackage.yaml.
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.yaml.
For other inquiries, contact datahub@datopian.com