GET
/v1/payments/institutionsGet Institution List
Retrieves the list of supported financial institutions available in the system. This endpoint returns details of institutions (BANKs and MNOs) such as the institution name, code, currency, payment slug, and type.
Details
AuthorizationBearer API Key
Content TypeApplication/Json
URLhttps://360pay-merchant-api.libertepay.com/v1/payments/institutions
MethodGET
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| type | string | Yes | Specifies the type of institutions to retrieve. Accepted values are: MNO (Mobile Network Operators) or BANK (Banks). |
Parameters Description
| Parameter | Type | Required | Description |
|---|---|---|---|
| type | String | Yes | Specifies the type of institutions to retrieve. Accepted values are: MNO (Mobile Network Operators) or BANK (Banks). |
Response Fields
| Field | Type | Description |
|---|---|---|
| code | string | Issuer routing / institution code |
| currency | string | Currency supported by the institution (e.g. GHS) |
| name | string | Name of the financial institution |
| slug | string | Payment slug used for the institution (e.g. mtn, telecel-cash) |
| type | string | Institution type (MNO or BANK) |
Status Codes
200Success
400Invalid type parameter
401Unauthorized
500System error
Try It
Response Body
{
"code": "00",
"data": [
{
"code": "string",
"currency": "string",
"name": "string",
"slug": "string",
"type": "string"
}
],
"msg": "Application Institutions",
"status": "SUCCESS"
}