---
id: pypostalcode
version: "0.4.1"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# pypostalcode — Radius searches on Canadian postal codes, location data

License: permissive · Maintenance: abandoned · Downloads: 196.0K/mo

## What it is and what it does

pypostalcode is a Canadian postal code database and lookup tool. It provides fast lookups of Forward Sortation Area (FSA) codes to retrieve associated city, province, geographic coordinates, and timezone data. The package also supports radius-based searches to find all postal codes within a specified distance in kilometers from a given FSA code.

The package has no runtime dependencies and installs cleanly as a pure Python wheel. It was last updated in June 2021 and is no longer actively maintained, so the underlying postal code data may not reflect recent changes to Canadian postal code assignments or geographic boundaries.

Use it for:

- Look up city and province information for a Canadian postal code in an application or data pipeline.
- Find all postal codes within a radius to support location-based filtering or geographic queries.
- Retrieve geographic coordinates and timezone for a postal code to support mapping or scheduling features.
- Validate or enrich Canadian address data with postal code lookups in batch processing.
- Support geolocation features in a web or mobile application serving Canadian users.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Looks up Canadian postal codes to retrieve city, province, geographic coordinates, and timezone information, and finds postal codes within a specified radius.

Yes, if you need Canadian postal code lookups and can accept that the data is frozen as of June 2021. The package is stable, has no dependencies, and installs easily. However, if you require current postal code data or active maintenance, you should verify the database currency against Canada Post's current FSA assignments before relying on it in production.

## Install

pip install pypostalcode
uv add pypostalcode
poetry add pypostalcode

## Installing pypostalcode

Before you install: Installation is straightforward with no runtime dependencies. The package is abandoned as of June 2021 with no recent maintenance, so expect no updates or bug fixes.

License in practice: MIT license is permissive and places no restrictions on use, modification, or distribution in commercial or private projects.

Quickstart:

pip install pypostalcode

from pypostalcode import PostalCodeDatabase
pcdb = PostalCodeDatabase()
location = pcdb['V5K']
print(location.city, location.province, location.latitude, location.longitude)

Verify before relying:

- Whether the postal code database is current or reflects changes to Canadian postal codes since the last 2021 release.
- Compatibility with modern Python versions, as the package specifies no explicit Python version requirement.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 196.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

canadian postal code lookup, postal code distance search, canadian city by postal code, postal code radius search, canada postal code database, postal code geocoding, canadian fsa lookup, geolocation, canadian-data, postal-codes

[View on SkillFed](https://skillfed.io/packages/pypostalcode) · [View on PyPI](https://pypi.org/project/pypostalcode/)