Mobile money operators

Lookup table for mobile money operators, for the currencies that pay to a mobile money wallet (GHS, KES). Returns the (slug, name, country, currency) tuples Swappr knows about, filtered to the operators you can actually pay to.

The slug is the value to send as mobile_operator on a mobile money payout. It is a stable, provider-neutral identifier: look the operator up here, then pass its slug on the payout. Do not hardcode operator strings, discover them from this endpoint so your integration keeps working as the list evolves.

GETList mobile money operators

GET/v1/momo_operators?currency=GHS

Returns the curated list of mobile money operators you can pay to for a currency, ordered by name. Heavily cached (5-minute TTL on Swappr’s side; safe to cache locally for hours).

Query parameters

currencystringRequired

The wallet currency. Supported values: GHS, KES.

Response fields

Field	Type	Notes
`slug`	string	Stable public identifier. Pass this as `mobile_operator` on a mobile money payout.
`name`	string	Operator display name (e.g. `MTN Ghana`).
`country`	string	ISO 3166-1 alpha-2 country code (e.g. `GH`, `KE`).
`currency`	string	The wallet currency for this operator (`GHS` or `KES`).

Notes

Only operators marked as merchant-exposed in our system, and that carry a public slug, appear here. An unvetted operator is never advertised.
The slug is provider-neutral and stable, safe to store against your own records.

Errors

Code	HTTP	Cause
`missing_currency`	400	The `currency` query param was not supplied.
`unsupported_currency`	400	Anything other than `GHS` or `KES`.

Request

curl 'https://api.swappr.me/api/v1/momo_operators?currency=GHS' \
  -H "Authorization: Bearer sk_live_..."

// Fetch once at app start, cache in memory
type MomoOperator = { slug: string; name: string; country: string; currency: string };
let operators: MomoOperator[] | null = null;
let operatorsExpiresAt = 0;
 
async function getMomoOperators(currency: 'GHS' | 'KES'): Promise<MomoOperator[]> {
  if (operators && Date.now() < operatorsExpiresAt) return operators;
 
  const res = await fetch(`https://api.swappr.me/api/v1/momo_operators?currency=${currency}`, {
    headers: { 'Authorization': `Bearer ${process.env.SWAPPR_API_KEY}` },
  });
  const data = await res.json();
 
  operators = data.data;
  operatorsExpiresAt = Date.now() + 60 * 60 * 1000; // 1h
  return operators;
}

import os, time, requests
from typing import Optional
 
# Fetch once at app start, cache in memory.
_operators: Optional[list] = None
_operators_expires_at: float = 0
 
def get_momo_operators(currency: str) -> list:
    global _operators, _operators_expires_at
    if _operators and time.time() < _operators_expires_at:
        return _operators
 
    res = requests.get(
        'https://api.swappr.me/api/v1/momo_operators',
        params={'currency': currency},
        headers={'Authorization': f"Bearer {os.environ['SWAPPR_API_KEY']}"},
    )
    res.raise_for_status()
 
    _operators = res.json()['data']
    _operators_expires_at = time.time() + 60 * 60  # 1h
    return _operators

Response

{
  "object": "list",
  "data": [
    {
      "slug": "airteltigo-ghana",
      "name": "AirtelTigo Ghana",
      "country": "GH",
      "currency": "GHS"
    },
    {
      "slug": "mtn-ghana",
      "name": "MTN Ghana",
      "country": "GH",
      "currency": "GHS"
    },
    {
      "slug": "telecel-ghana",
      "name": "Telecel Ghana",
      "country": "GH",
      "currency": "GHS"
    }
  ]
}

200 OK

Banks Currencies