Skip to main content
Call this endpoint to get the full list of Nigerian banks that Shogun supports, along with the bank code for each. You need a bank code whenever you call Name Enquiry or Funds Transfer for an inter-bank transaction. Fetch this list once, cache it in your application, and present it to your users as a bank selection menu.

​
Endpoint

POST https://baasapi.payrepmfb.com/api/v1/transaction/transfer/api/fetch_banks
No request body is required.

​
Authentication

Pass your bearer JWT in the Authorization header. Obtain a token from Generate Token. 
Authorization: Bearer <access_token>

​
Request example

curl -X POST https://baasapi.payrepmfb.com/api/v1/transaction/transfer/api/fetch_banks \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json"

​
Responses

​
200 — Banks retrieved

The response returns an array of bank objects under data. 
{
  "status": true,
  "response_code": "00",
  "message": "Banks retrieved successfully",
  "data": [
    {
      "name": "Access Bank",
      "code": "044",
      "cbn_code": "000014",
      "updated_at": "2026-01-15T09:00:00Z"
    },
    {
      "name": "Guaranty Trust Bank",
      "code": "058",
      "cbn_code": "000013",
      "updated_at": "2026-01-15T09:00:00Z"
    },
    {
      "name": "Payrep MFB",
      "code": "090823",
      "cbn_code": null,
      "updated_at": "2026-01-15T09:00:00Z"
    },
    {
      "name": "Zenith Bank",
      "code": "057",
      "cbn_code": "000015",
      "updated_at": "2026-01-15T09:00:00Z"
    }
  ]
}

​
Response fields

​
data
array
Array of bank objects, one per supported Nigerian bank.
​
data[].name
string
Full display name of the bank. Use this to populate your bank selection UI.
​
data[].code
string
The bank code to pass as bank_code in Name Enquiry and Funds Transfer requests. For intra-bank transfers to Payrep MFB accounts, the code is 090823.
​
data[].cbn_code
string | null
The Central Bank of Nigeria (CBN) institution code for the bank. May be null for microfinance banks.
​
data[].updated_at
string
ISO 8601 timestamp of when the bank record was last updated in Shogun’s database.
Cache the bank list in your application for at least 24 hours. The list changes infrequently — fetching it on every transfer adds unnecessary latency. Refresh your cache daily or when a user reports that a bank code is rejected.