> For the complete documentation index, see [llms.txt](https://docs.tylt.money/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tylt.money/tylt-crossramp-fiat-crypto-solutions/philippines-php/instapay-payout-php-usdt/get-supported-institutions.md).

# Get Supported Institutions

This endpoint retrieves the list of supported receiving banks or institutions for a specific provider and channel.

***

**End Point**

<mark style="color:green;">**`GET`**</mark>` ``https://api.tylt.money/v2/prime-fiat/php/institutions/v2/list?provider={}&channel={}`

**Example Request**

<mark style="color:green;">**`GET`**</mark>`https://api.tylt.money/v2/prime-fiat/php/institutions/v2/list?provider=Pisomind&channel=pesonet`

**Request Headers**

{% tabs %}
{% tab title="Headers" %}

<table data-full-width="true"><thead><tr><th width="133">Name</th><th width="79">Type</th><th width="167">Example</th><th>Description</th></tr></thead><tbody><tr><td>X-TLP-APIKEY</td><td>string</td><td>93ee3c5e133697251b5362bcf9cc8532476785t8768075616f58d88</td><td>Your Tylt API Key, used to identify your account in API requests.</td></tr><tr><td>X-TLP-SIGNATURE</td><td>string</td><td>d0afef3853dfc8489c8b9affa5825171fdd7y7685675e4966a05f66ed2b3eaf9462b3c9c0</td><td>HMAC SHA-256 signature generated using the API Secret Key to secure the request.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

**Query Parameters**

| Parameter  | Required | Description                                                                      |
| ---------- | -------- | -------------------------------------------------------------------------------- |
| `provider` | Yes      | The provider to fetch institutions from. Accepted values: `Pisomind`, `Connecx`. |
| `channel`  | Yes      | The payment rail or channel for the selected provider.                           |

**Notes**

* Both `provider` and `channel` are mandatory.
* `provider` is case-insensitive.
* For `Pisomind`, only `instapay` and `pesonet` are valid channel values.
* For `Connecx`, pass the exact Connecx bank code identifier as the `channel`.
* The response format remains the same for both providers.

**Code Snippet**

{% tabs %}
{% tab title="Node JS" %}

```javascript
const axios = require('axios');
const crypto = require('crypto');

// Replace with your API Key and Secret
const apiKey = 'your-api-key';
const apiSecret = 'your-api-secret';

// Request params
const params = {
  provider: 'Pisomind',
  channel: 'pesonet'
};

// Create HMAC SHA-256 signature using the request params
const signature = crypto
  .createHmac('sha256', apiSecret)
  .update(JSON.stringify(params))
  .digest('hex');

// Define headers
const headers = {
  'x-api-key': apiKey,
  'X-TLP-SIGNATURE': signature,
  'Content-Type': 'application/json'
};

// Send the GET request
axios.get('https://api.tylt.money/v2/prime-fiat/php/institutions/v2/list', {
  headers,
  params
})
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error.response ? error.response.data : error.message);
  });
```

{% endtab %}
{% endtabs %}

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
  "msg": "Institutions retrieved",
  "data": {
    "institutions": [
      {
        "code": "CSPA001PH",
        "name": "PayMaya",
        "rail": "PHPCIS-1001"
      },
      {
        "code": "CSMK001PH",
        "name": "Maya Bank",
        "rail": "PHPCIS-1001"
      }
    ]
  }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "msg": "Invalid channel for Pisomind! Allowed values are instapay, pesonet.",
  "data": {}
}
```

{% endtab %}

{% tab title="Response Fields" %}

| Field         | Description                                                       |
| ------------- | ----------------------------------------------------------------- |
| `code`        | Institution code to be used when creating a payout.               |
| `name`        | Name of the receiving bank, wallet, or institution.               |
| `rail`        | Payment rail or provider channel associated with the institution. |
| {% endtab %}  |                                                                   |
| {% endtabs %} |                                                                   |