Developer Center

REST APIs Overview

Last Updated: Oct 04, 2018 08:43AM CEST

Being RESTful

Mambu API follow the Representational state transfer (REST) standard allowing resources (accounts, client, etc) to be standard with a standard set of GET, POST, PUT, DELETE, PATCH HTTP requests.
Communication with Mambu follows the REST architecture constraints including being stateless & cacheable.
All responses are returned as JSON objects .


Mambu is a multi-tenanted environment with all tenants having access at their own sub-domain. To make a request to a tenant use the pattern of ?<tenanId>

Posting Data

API requests which post data can either use url-encoding or json to enter data. The content-type header must be set to "application/json" for the json request. The following two example shows the two methods for posting data. Note that for some requests, much more information can be posted using the json input that is available with url-encoding but all url-encoded requests are supported with their json equivalents.
//using just url encoding
    curl -d "type=APPROVAL"

    //using json
    curl -H "Accept: application/json" -H "Content-type: application/json" -X POST -d '{ "type": "APPROVAL"}'


The follow example makes a request using the username 'user', the password 'pword' to the tenant 'demo' to retrieve all repayments for loan account 'abc'

And returns a response such as:
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found