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

# List Institutions

> Retrieve supported payout banks and institution codes for a currency.

Retrieve all institutions eligible for payout within a given local currency.

### Path Parameters

<ParamField path="currency_code" type="string" required>
  The target currency code (e.g. `NGN`, `KES`, `UGX`, `TZS`, `MWK`, `BRL`).
</ParamField>

### Response

Returns list of bank routing codes.

<ResponseField name="status" type="string">
  Response state (`success`).
</ResponseField>

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

  <ResponseField name="code" type="string">
    The institution routing code.
  </ResponseField>

  <ResponseField name="name" type="string">
    The institution name.
  </ResponseField>

  <ResponseField name="type" type="string">
    The payout type for this corridor.
  </ResponseField>
</ResponseField>

***

### Example Payloads

<RequestExample>
  ```http Get Institutions theme={null}
  GET /v1/institutions/KES HTTP/1.1
  Host: b2b.usetapp.xyz
  ```
</RequestExample>

<ResponseExample>
  ```json Response (200 OK) theme={null}
  {
    "status": "success",
    "message": "Institutions retrieved",
    "data": [
      {
        "code": "MOMOKESA",
        "name": "M-Pesa",
        "type": "mobile_money"
      },
      {
        "code": "KCBKES01",
        "name": "KCB Bank",
        "type": "bank"
      }
    ]
  }
  ```
</ResponseExample>
