Skip to main content
GET
/
v1
/
institutions
/
{currency_code}
GET /v1/institutions/KES HTTP/1.1
Host: api.rails.dev

{
  "status": "success",
  "message": "Institutions retrieved",
  "data": [
    {
      "code": "MOMOKESA",
      "name": "M-Pesa",
      "type": "mobile_money"
    },
    {
      "code": "KCBKES01",
      "name": "KCB Bank",
      "type": "bank"
    }
  ]
}
Retrieve all institutions eligible for payout within a given local currency.

​
Path Parameters

​
currency_code
string
required
The target currency code (e.g. NGN, KES, UGX, TZS, MWK, BRL).

​
Response

Returns list of bank routing codes.
​
status
string
Response state (success).
​
data
array
List of institutions.
​
code
string
The institution routing code.
​
name
string
The institution name.
​
type
string
The payout type for this corridor.

​
Example Payloads

GET /v1/institutions/KES HTTP/1.1
Host: api.rails.dev

{
  "status": "success",
  "message": "Institutions retrieved",
  "data": [
    {
      "code": "MOMOKESA",
      "name": "M-Pesa",
      "type": "mobile_money"
    },
    {
      "code": "KCBKES01",
      "name": "KCB Bank",
      "type": "bank"
    }
  ]
}