Get Service Inventory

GET /api-access/api/service-inventory/momo-providers

Get service inventory for mobile money providers.

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

Query Parameters:

Parameter	Type	Required	Description	Available Values
country	string	No	The country to get the mobile money providers for	bj, bf, ci, gw, ml, ne, sn, tg

Response

Success Response (200):

{
  "data": [
    {
      "country": "string",
      "currency": "string",
      "transaction_type": "payin",
      "enabled": true,
      "operator": "string"
    }
  ],
  "success": true,
  "message": "string",
  "detail": {}
}

Response Fields:

Field	Type	Description
data	array	Array of service inventory objects
data[].country	string	Country code
data[].currency	string	Currency code
data[].transaction_type	string	Transaction type (e.g., payin, payout)
data[].enabled	boolean	Whether the service is enabled
data[].operator	string	Mobile money operator name

Example

cURL

curl -X GET "https://sandbox.mara.boo/api-access/api/service-inventory/momo-providers?country=bj" \
  -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/service-inventory/momo-providers?country=bj', {
  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/service-inventory/momo-providers',
    params={'country': 'bj'},
    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()

Error Responses

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

Related

• Get Mobile Money Providers