curl "https://sandbox.core.linkio.world/api/payments/banks?currency=GHS" \
-H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
-H "API-Version: 2026-10-29-atlas"
{
"status": "success",
"message": "GHS payment banks retrieved",
"count": 2,
"banks": [
{ "name": "Absa Bank Ghana Ltd", "code": "030100" },
{ "name": "Access Bank", "code": "280100" }
]
}
Lookups
List banks
Get the banks and their codes for a currency.
GET
/
payments
/
banks
curl "https://sandbox.core.linkio.world/api/payments/banks?currency=GHS" \
-H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
-H "API-Version: 2026-10-29-atlas"
{
"status": "success",
"message": "GHS payment banks retrieved",
"count": 2,
"banks": [
{ "name": "Absa Bank Ghana Ltd", "code": "030100" },
{ "name": "Access Bank", "code": "280100" }
]
}
Requires the Ramps, banks & methods scope (banks read). Use the
code as bank_code in offramp payout details.
Headers
string
default:"2026-10-29-atlas"
required
Your account’s API version.
Query
string
required
For example
NGN or GHS. Upper or lower case.Response
200 OK
string
successstring
For example
NGN payment banks retrieved.integer
How many banks.
array
Each bank has a
name and, usually, a code.Errors
| Status | Code | Why |
|---|---|---|
422 | validation_failed | Unsupported currency. The message lists the supported ones. |
curl "https://sandbox.core.linkio.world/api/payments/banks?currency=GHS" \
-H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
-H "API-Version: 2026-10-29-atlas"
{
"status": "success",
"message": "GHS payment banks retrieved",
"count": 2,
"banks": [
{ "name": "Absa Bank Ghana Ltd", "code": "030100" },
{ "name": "Access Bank", "code": "280100" }
]
}
Last modified on October 29, 2026
Was this page helpful?