Skip to content
Python wrapper for the PostNL API, a way to track packages using their online portal.
Python
Branch: master
Clone or download
2 authors and iMicknl Fixed the case when there is no delivery date yet (#13)
* fixed case when there is no delivery date yet. Fixed test case with letters

* updated version + changelog

* reverted a potential breaking change

* Update postnl_api/items/package.py

Co-Authored-By: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>
Latest commit 9d8fdc3 Sep 13, 2019

README.md

python-postnl-api

(Unofficial) Python wrapper for the PostNL API (Dutch Postal Services), which can be used to track packages and letter deliveries. You can use your jouw.postnl.nl credentials to use the API.

Quick test

When installed:

python -m postnl_api.test_postnl_api USERNAME PASSWORD

Or running directly:

test_postnl_api.py USERNAME PASSWORD

Code Example

from postnl_api import PostNL_API

# Login using your jouw.postnl.nl credentials
postnl = PostNL_API('email@domain.com', 'password')

# Get relevant deliveries
print("Getting relevant deliveries")
rel_deliveries = postnl.get_relevant_deliveries()
for delivery in rel_deliveries:
    print(delivery.debug_string)

# Get relevant deliveries
print("Getting all deliveries")
all_deliveries = postnl.get_deliveries()
for delivery in all_deliveries:
    print(delivery.debug_string)

# Get relevant deliveries
print("Getting all distributions (sent packages)")
distributions = postnl.get_distributions()
for distribution in distributions:
    print(distribution.debug_string)

# Get letters
print("Getting all letters, if that function is turned on")
letters = postnl.get_letters()
for letter in letters:
    print(letter.debug_string)

Miscellaneous

This blogpost describes the process of figuring out the API endpoints and shows how this can be done for other API's.

Changelog

See the CHANGELOG file.

Contributors

License

MIT

You can’t perform that action at this time.