Mansa African Financial Reference Data

Identify an African bank from any identifier you hold: its name, domestic sort/bank code, SWIFT/BIC code, or USSD shortcode. Works as a reverse lookup, so pass a bare SWIFT code like 'NLCBTZTX' to find out which institution it belongs to. Returns the bank's name, country, type, bank code, SWIFT/BIC, USSD shortcode and whether it supports mobile money.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Bank name, bank/sort code, SWIFT/BIC code, or USSD shortcode."
    },
    "country": {
      "type": "string",
      "description": "Optional ISO-2 country code to scope the search (e.g. NG, GH, KE, ZA, TZ)."
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 10, max 50)."
    }
  },
  "required": [
    "query"
  ]
}

List every bank and financial institution held for a country, with its bank code, SWIFT/BIC, USSD shortcode and mobile-money flag. Use this to build a bank picker or to reconcile a list of institutions.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "ISO-2 country code, e.g. NG, GH, KE, ZA, EG, MA, ZM, TZ."
    },
    "mobile_money_only": {
      "type": "boolean",
      "description": "Return only mobile-money providers (default false)."
    }
  },
  "required": [
    "country"
  ]
}

Work out which Nigerian banks a 10-digit NUBAN account number could belong to. The CBN check digit is computed from the bank code plus the first nine digits, so testing the number against every bank code narrows a shortlist without contacting any bank. Typically reduces ~30 banks to ~3. This confirms checksum validity only: it does NOT confirm the account exists, and it never returns the account holder's name, which requires a licensed NIBSS account-name enquiry.

{
  "type": "object",
  "properties": {
    "account": {
      "type": "string",
      "description": "The 10-digit Nigerian account number."
    },
    "bank_code": {
      "type": "string",
      "description": "Optional. If given, validate against just this bank code instead of scanning all."
    }
  },
  "required": [
    "account"
  ]
}

Resolve an African phone number to its mobile network operator from the number's prefix. Accepts local or international format. Useful for routing a mobile-money payout to the right provider or validating a number before sending an OTP.

{
  "type": "object",
  "properties": {
    "phone": {
      "type": "string",
      "description": "Phone number, local (08031234567) or international (+2348031234567)."
    }
  },
  "required": [
    "phone"
  ]
}

Return the public holidays for a country and calendar year, with each holiday's date, name and type. Names are returned in English wherever the country publishes it; pass a language code for others (Kenya also publishes Swahili).

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "ISO-2 country code, e.g. NG, KE, GH, ZA."
    },
    "year": {
      "type": "number",
      "description": "Four-digit calendar year, e.g. 2026."
    },
    "lang": {
      "type": "string",
      "description": "Optional language code for holiday names, e.g. 'sw' for Swahili."
    }
  },
  "required": [
    "country",
    "year"
  ]
}

Return the ISO 4217 record for a currency: its code, name, symbol, how many decimal places it uses, and every country that uses it.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "ISO 4217 currency code, e.g. NGN, KES, XAF, ZAR."
    }
  },
  "required": [
    "code"
  ]
}