Get Fee

GET /api-access/api/fees/{id}

Retrieve a specific fee by ID.

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

Path Parameters:

Parameter	Type	Required	Description
id	string	Yes	Fee ID

Response

Success Response (200):

{
  "data": {
    "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:16:15.563Z",
    "updated_at": "2025-10-12T18:16:15.563Z"
  },
  "success": true,
  "message": "string",
  "detail": {}
}

Response Fields:

Field	Type	Description
data	object	Fee object
data.revenue_line	string	Revenue line type (e.g., subscription)
data.is_active	boolean	Whether the fee is active
data.monthly_fee_amount	number	Monthly fee amount
data.channel	string	Payment channel (e.g., mobile_money)
data.base_currency	string	Base currency code (e.g., xof)
data.target_currency	string	Target currency code (e.g., xof)
data.maraboo_flat_fee	number	Maraboo flat fee amount
data.maraboo_percentage_fee	number	Maraboo percentage fee
data.partner_flat_fee	number	Partner flat fee amount
data.partner_percentage_fee	number	Partner percentage fee
data.fx_partner_percentage_fee	number	Foreign exchange partner percentage fee
data.tax_percentage	number	Tax percentage
data.id	string	Fee ID
data.plan_id	string	Plan ID
data.created_at	string	Creation timestamp (ISO 8601)
data.updated_at	string	Last update timestamp (ISO 8601)

Examples

cURL

curl -X GET "https://sandbox.mara.boo/api-access/api/fees/{id}" \
  -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 feeId = 'fee-id-here';
const response = await fetch(`https://sandbox.mara.boo/api-access/api/fees/${feeId}`, {
  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

fee_id = 'fee-id-here'
response = requests.get(
    f'https://sandbox.mara.boo/api-access/api/fees/{fee_id}',
    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"
    "fmt"
)

func main() {
    feeID := "fee-id-here"
    url := fmt.Sprintf("https://sandbox.mara.boo/api-access/api/fees/%s", feeID)

    client := &http.Client{}
    req, _ := http.NewRequest("GET", url, 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;

String feeId = "fee-id-here";
String url = "https://sandbox.mara.boo/api-access/api/fees/" + feeId;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create(url))
    .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 feeId = "fee-id-here";
var url = $"https://sandbox.mara.boo/api-access/api/fees/{feeId}";

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, url);

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
400	Bad Request - Invalid fee ID format
401	Unauthorized - Invalid authentication
403	Forbidden - Missing required headers
404	Not Found - Fee doesn't exist
500	Internal Server Error

Related

• Get Fees