Get Mobile Money Providers

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

Get 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:

Name	Type	Location	Description	Available Values
provider	any	query	Mobile money provider	hub2, bizao
operator	string	query	Mobile money operator	-
country	any	query	Country name	benin, burkina faso, cote d'ivoire, guinea-bissau, mali, niger, senegal, togo
country_code	any	query	ISO country code	bj, bf, ci, gw, ml, ne, sn, tg

Response

Success Response (200):

{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "provider_name": "hub2",
      "country_code": "bj",
      "country_name": "benin",
      "operator": "string",
      "telco": [
        "string"
      ],
      "logo": "string"
    }
  ],
  "success": true,
  "message": "string",
  "detail": {}
}

Example

cURL

curl -X GET "https://sandbox.mara.boo/api-access/api/service-inventory/momo-providers" \
  -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"

Error Responses

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