The next generation of address finders, AddressComplete uses intelligent, fast searching to improve data accuracy and relevancy. Simply start typing a business name, address or Postal Code and AddressComplete will suggest results as you go. Using Geocoder you can retrieve CanadaPost’s geocoded data from Addres Complete API.

Geocoding (Postal Code)

>>> import geocoder
>>> g = geocoder.canadapost('453 Booth Street, Ottawa', key='<API KEY>')
>>> g.postal
'K1R 7K9'
>>> g.json

Command Line Interface

$ geocode '453 Booth Street, Ottawa' --provider canadapost | jq .postal

Environment Variables

To make sure your API key is store safely on your computer, you can define that API key using your system’s environment variables.

$ export CANADAPOST_API_KEY=<Secret API Key>


  • location: Your search location you want geocoded.
  • key: (optional) API Key from CanadaPost Address Complete.
  • language: (default=en) Output language preference.
  • country: (default=ca) Geofenced query by country.
  • method: (default=geocode) Use the following:
    • geocode