> ## Documentation Index
> Fetch the complete documentation index at: https://developer.nomba.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Institution Providers

> Retrieve available banks and mobile money providers for Global Payout transfers

<Card title="Institution Providers" icon="building-columns" href="/nomba-api-reference/global-payout/mobile-money-providers" />

# `GET /v1/global-payout/bank/providers`

Returns available bank, institution, or mobile money providers. Use the `isMobileMoney` query parameter to switch between bank/institution and mobile money listings.

Use the `code` from the response as `institutionCode` and `displayName` as `institutionName` in the [Authorize Transfer](/docs/products/global-payout/authorize-transfer) request.

#### Query parameters

<ParamField query="isMobileMoney" type="boolean">
  `false` returns bank or institution providers. `true` returns mobile money providers.
</ParamField>

<ParamField query="countryIsoCode" type="string">
  ISO 3166-1 alpha-2 destination country code (e.g., `KE`, `ZA`, `GH`, `ET`, `RW`). When provided, takes priority over the region derived from your JWT. Use this when your platform supports multiple destination countries — pass the recipient's country code to get the correct provider list.
</ParamField>

<CodeGroup>
  ```bash Institutions (isMobileMoney=false) theme={null}
  curl --request GET \
    --url 'https://api.nomba.com/v1/global-payout/bank/providers?countryIsoCode=US&isMobileMoney=false' \
    --header 'Authorization: Bearer <token>' \
    --header 'accountId: <accountId>'
  ```

  ```bash Mobile Money (isMobileMoney=true) theme={null}
  curl --request GET \
    --url 'https://api.nomba.com/v1/global-payout/bank/providers?isMobileMoney=true' \
    --header 'Authorization: Bearer <token>' \
    --header 'accountId: <accountId>'
  ```

  ```json Response — Institutions theme={null}
  {
    "code": "00",
    "description": "Success",
    "status": false,
    "data": [
      { "code": "access_bank", "displayName": "Access Bank" },
      { "code": "bank_of_africa", "displayName": "Bank Of Africa" },
      { "code": "eco_bank", "displayName": "Eco Bank" },
      { "code": "equity_bank", "displayName": "Equity Bank" },
      { "code": "raw_bank", "displayName": "Raw Bank" },
      { "code": "uba", "displayName": "United Bank of Africa" }
    ]
  }
  ```

  ```json Response — Institution Providers (Mobile Money) theme={null}
  {
    "code": "00",
    "description": "Success",
    "status": false,
    "data": [
      { "code": "nomba", "displayName": "Nomba" },
      { "code": "airtel", "displayName": "Airtel Money" },
      { "code": "mpesa", "displayName": "Mpesa" },
      { "code": "orange", "displayName": "Orange" }
    ]
  }
  ```
</CodeGroup>

<Tip>
  Always pass `countryIsoCode` when calling this endpoint. Multiple countries share the same currency (e.g., XOF covers Senegal and Côte d'Ivoire; XAF covers Cameroon and Gabon) — the country code is how the API returns the correct provider list for your destination. `code` from this endpoint → `institutionCode` in the transfer request. `displayName` → `institutionName`.
</Tip>

## Providers by Country

| Country       | ISO Code | Currency  | Institution Providers                 |
| ------------- | -------- | --------- | ------------------------------------- |
| DR Congo      | CD       | USD / CDF | Nomba, Airtel Money, M-Pesa, Orange   |
| Kenya         | KE       | KES       | M-Pesa                                |
| Ghana         | GH       | GHS       | MTN Mobile Money                      |
| South Africa  | ZA       | ZAR       | Bank only — use `isMobileMoney=false` |
| Senegal       | SN       | XOF       | Orange Money, Wave                    |
| Côte d'Ivoire | CI       | XOF       | Orange Money, MTN, Moov, Wave         |
| Ethiopia      | ET       | ETB       | Safaricom M-Pesa, Ethio Telecom       |
| Rwanda        | RW       | RWF       | MTN Mobile Money, Airtel Money        |
| Uganda        | UG       | UGX       | MTN Mobile Money, Airtel Money        |
| Cameroon      | CM       | XAF       | MTN Mobile Money, Orange Money        |
| Gabon         | GA       | XAF       | Airtel Money, Moov                    |
| UAE           | AE       | AED       | Bank only — use `isMobileMoney=false` |

<Note>
  Provider codes (`institutionCode`) and display names (`institutionName`) returned by this endpoint are the canonical values — always call the API rather than hardcoding them, as they may be updated.
</Note>

#### Response body

<ResponseField name="data" type="array" required>
  List of available institutions.

  <Expandable title="institution object" defaultOpen="true">
    <ResponseField name="code" type="string">
      The institution code. Use this as `institutionCode` in the [Authorize Transfer](/docs/products/global-payout/authorize-transfer) request.
    </ResponseField>

    <ResponseField name="displayName" type="string">
      Human-readable institution name. Use this as `institutionName` in the [Authorize Transfer](/docs/products/global-payout/authorize-transfer) request.
    </ResponseField>
  </Expandable>
</ResponseField>