Get Fees

GET /api-access/api/fees

Retrieve a list of fees for your business account.

Authentication

Required Headers:

Authorization: HMAC-SHA256 PUBLIC_KEY:PRIVATE_KEY
X-Origin: third-party-api
X-Timestamp: 2025-10-12T14:30:00.000Z
Content-Type: application/json

Request

This endpoint does not require any query parameters.

Response

Success Response (200):

{
  "items": [
    {
      "fees": [
        {
          "revenue_line": "subscription",
          "is_active": true,
          "monthly_fee_amount": 0,
          "channel": "mobile_money",
          "base_currency": "xof",
          "target_currency": "xof",
          "maraboo_flat_fee": 0,
          "maraboo_percentage_fee": 0,
          "partner_flat_fee": 0,
          "partner_percentage_fee": 0,
          "fx_partner_percentage_fee": 0,
          "tax_percentage": 0,
          "id": "string",
          "plan_id": "string",
          "created_at": "2025-10-12T18:15:45.258Z",
          "updated_at": "2025-10-12T18:15:45.258Z"
        }
      ],
      "total": 0,
      "limit": 0,
      "offset": 0
    }
  ],
  "total": 0,
  "offset": 0,
  "limit": 0
}

Response Fields:

Field	Type	Description
items	array	Array of fee group objects
items[].fees	array	Array of fee objects within the group
items[].fees[].revenue_line	string	Revenue line type (e.g., subscription)
items[].fees[].is_active	boolean	Whether the fee is active
items[].fees[].monthly_fee_amount	number	Monthly fee amount
items[].fees[].channel	string	Payment channel (e.g., mobile_money)
items[].fees[].base_currency	string	Base currency code (e.g., xof)
items[].fees[].target_currency	string	Target currency code (e.g., xof)
items[].fees[].maraboo_flat_fee	number	Maraboo flat fee amount
items[].fees[].maraboo_percentage_fee	number	Maraboo percentage fee
items[].fees[].partner_flat_fee	number	Partner flat fee amount
items[].fees[].partner_percentage_fee	number	Partner percentage fee
items[].fees[].fx_partner_percentage_fee	number	Foreign exchange partner percentage fee
items[].fees[].tax_percentage	number	Tax percentage
items[].fees[].id	string	Fee ID
items[].fees[].plan_id	string	Plan ID
items[].fees[].created_at	string	Creation timestamp (ISO 8601)
items[].fees[].updated_at	string	Last update timestamp (ISO 8601)
items[].total	number	Total number of fees in the group
items[].limit	number	Limit per page
items[].offset	number	Offset for pagination
total	number	Total number of fee groups
offset	number	Current offset
limit	number	Current limit

Examples

cURL

curl -X GET "https://sandbox.mara.boo/api-access/api/fees" \
  -H "Authorization: HMAC-SHA256 YOUR_PUBLIC_KEY:YOUR_PRIVATE_KEY" \
  -H "X-Origin: third-party-api" \
  -H "X-Timestamp: 2025-10-12T14:30:00.000Z" \
  -H "Content-Type: application/json"

JavaScript

const response = await fetch('https://sandbox.mara.boo/api-access/api/fees', {
  method: 'GET',
  headers: {
    'Authorization': 'HMAC-SHA256 YOUR_PUBLIC_KEY:YOUR_PRIVATE_KEY',
    'X-Origin': 'third-party-api',
    'X-Timestamp': '2025-10-12T14:30:00.000Z',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();

Python

import requests

response = requests.get(
    'https://sandbox.mara.boo/api-access/api/fees',
    headers={
        'Authorization': 'HMAC-SHA256 YOUR_PUBLIC_KEY:YOUR_PRIVATE_KEY',
        'X-Origin': 'third-party-api',
        'X-Timestamp': '2025-10-12T14:30:00.000Z',
        'Content-Type': 'application/json'
    }
)

data = response.json()

Go

package main

import (
    "net/http"
    "io/ioutil"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://sandbox.mara.boo/api-access/api/fees", nil)

    req.Header.Set("Authorization", "HMAC-SHA256 YOUR_PUBLIC_KEY:YOUR_PRIVATE_KEY")
    req.Header.Set("X-Origin", "third-party-api")
    req.Header.Set("X-Timestamp", "2025-10-12T14:30:00.000Z")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
}

Java

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://sandbox.mara.boo/api-access/api/fees"))
    .header("Authorization", "HMAC-SHA256 YOUR_PUBLIC_KEY:YOUR_PRIVATE_KEY")
    .header("X-Origin", "third-party-api")
    .header("X-Timestamp", "2025-10-12T14:30:00.000Z")
    .header("Content-Type", "application/json")
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

C#

using System.Net.Http;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://sandbox.mara.boo/api-access/api/fees");

request.Headers.Add("Authorization", "HMAC-SHA256 YOUR_PUBLIC_KEY:YOUR_PRIVATE_KEY");
request.Headers.Add("X-Origin", "third-party-api");
request.Headers.Add("X-Timestamp", "2025-10-12T14:30:00.000Z");
request.Headers.Add("Content-Type", "application/json");

var response = await client.SendAsync(request);
var content = await response.Content.ReadAsStringAsync();

Error Responses

Status Code	Description
401	Unauthorized - Invalid authentication
403	Forbidden - Missing required headers
500	Internal Server Error

Related

• Get Fee