A python lib for using Mambu APIs
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Build Status


A python API for using Mambu.

Allows accessing Mambu via its REST API. Also includes SQLAlchemy mappings to a backup of its DataBase.

Mambu is a cloud platform which lets you rapidly build, integrate, launch and service any lending portfolio into any market (https://www.mambu.com).


Mambu allows communicating via a RESTful API (documented at https://developer.mambu.com/).

MambuPy includes a set of classes whose purpose is connecting to this REST Api and work with Mambu entities on your python scripts.

You must configure your Mambu account for allowing an API user to connect with it for this functionality to work.

For more information, look at the MambuStruct class and all the classes inheriting from it. MambuPy implements this at all the scripts named mambu*.py

Mambu Database Backup

Mambu also allows their users to download a dump of its database. It is a MySQL schema, documented at https://developer.mambu.com.

MambuPy includes a set of SQLAlchemy mappings that can connect to the Mambu database dump.

You must download a valid dump of your Mambu database, and then extract and restore on a local MySQL server of your own for this functionality to work.

For more information, look at the scripts named schema*.py


Currently MambuPy works on Python 2.7 and Python 3.6

You may install MambuPy by git-cloning this repository on your local environment and making it available anywhere on your PYTHONPATH.

You may also use pip install mambupy but please consider that the current configuration process doesn't works well with this kind of installation.


You must configure your local MambuPy environment first so you can correctly use this module.

Look at mambuconfig.py for more information.

Work in progress

MambuPy is a work in progress, on a very early stage of its development.

Currently it allows a limited connection to some of the more important Mambu entitites accessible via its REST API.

Also, not all of the Mambu Database schema is currently mapped.

Finally, also note that Mambu itself delivers changes on a regular basis that may include new functionality on its REST API, and changes on its database tables. Currently MambuPy works with the last version of Mambu but NOT ALL of its functionality is implemented. Making a complete implementation of the REST API and the mapping of the Database, and keeping them up to date with the last version of Mambu, is one of the main objectives of the MambuPy project.

Please consider supporting the project by forking, improving and pull-requesting it.


TODO comments for hackers are included at:

  • TODO file
  • pydoc string at __init__.py
  • pydoc strings all around the code

Release Notes

  • v0.8 first release notes 2018-04-20
    • implementation of PATCH request method on MambuStruct
    • implementation of MambuTask entity and MambuTasks iterable
    • v0.8.1 and v0.8.2 are identical to v0.8.1
  • v0.8.3 2018-05-22
    • MambuStruct convertDict2Attrs constantFields added 'email'
    • mambuuser unittests
    • mamburoles module
    • MambuUser setRoles() method
    • MambuTask close() method
  • v0.8.4 2018-07-18
    • Sphinx documentation and ReadTheDocs site
  • v0.9.0 2018-08-06
    • reallocation of modules in packages according to functionality
  • v1.0.0 2018-08-31
    • support for Python 3 ready!


JNC jstitch@gmail.com