• N26 Python CLI/API
  • About
  • Install
  • Configuration
  • Usage
    • CLI example
    • API example
  • Projects using python-n26
  • Contribute
    • Run locally
  • Maintainers
  • Credits
  • Disclaimer

python-n26 is a Command Line Interface to request information from n26 bank accounts and a Python 3 module that can be used in Python projects.

Disclaimer: This is an unofficial community project which is not affiliated with N26 GmbH/N26 Inc.

pip3 install n26
wget https://raw.githubusercontent.com/femueller/python-n26/master/n26.yml.example -O ~/.config/n26.yml
# configure username and password
vim ~/.config/n26.yml

You can use a YAML configuration file in ~/.config/n26.yml:

n26:
  username: "john.doe@example.com"
  password: "$upersecret"
  login_data_store_path: "~/.config/n26/token_data"

or use environment variables:

• N26_USER: username
• N26_PASSWORD: password
• N26_LOGIN_DATA_STORE_PATH: optional file path to store login data (recommended for cli usage)

Note that when specifying both environment variables as well as a config file and a key is present in both locations the enviroment variable values will be preferred.

Since 14th of September 2019 N26 requires a login confirmation (2 factor authentication) from the paired phone N26 app to login on devices that are not paired. This means you will receive a notification on your phone when you start using this library to request data. python-n26 checks for your login confirmation every 5 seconds. If you fail to approve the login request within 60 seconds an exception is raised.

If you do not specify a login_data_store_path this login information is only stored in memory. In order to avoid that every CLI command requires a new confirmation, the login data retrieved in the above process can be stored on the file system. Please note that this information must be protected from the eyes of third parties at all costs. You can specify the location to store this data in the Configuration.

> n26 balance
123.45 EUR

Or if using environment variables:

> N26_USER=user N26_PASSWORD=passwd n26 balance
123.45 EUR

from n26 import api
balance = api.Api()
print(balance.get_balance())

This is going to use the same mechanism to load configuration as the CLI tool, to specify your own configuration you can use it as:

from n26 import api
from n26 import config
conf = config.Config('username', 'passwd', '~/.config/n26/token_data')
client = api.Api(conf)
print(client.get_balance())

The following projects are using python-n26:

• home-assistant: https://www.home-assistant.io/components/n26

If there are any issues, bugs or missing API endpoints, feel free to contribute by forking the project and creating a Pull-Request.

Prerequirements: Pipenv

git clone git@github.com:femueller/python-n26.git
cd python-n26
pipenv shell
pipenv install
python3 -m n26 balance

• Markus Ressel
• Felix Mueller

• Nick Jüttner for providing the API authentication flow
• Pierrick Paul for providing the API endpoints

This project is not affiliated with N26 GmbH/N26 Inc. if you want to learn more about it, visit https://n26.com/.