POST /transfer/web/fetch_banks

Retrieve the list of supported Nigerian banks and their codes via the Dashboard API. Bank codes are required for transfers and name enquiry.

Use this endpoint to retrieve the full list of Nigerian banks supported by the Shogun platform, along with their corresponding bank codes. Bank codes are required fields when calling Name Enquiry and Funds Transfer. Cache the result in your application and refresh it periodically — the list of banks changes infrequently.

Endpoint

POST https://baasapi.payrepmfb.com/api/v1/transaction/transfer/web/fetch_all_banks

Sandbox

POST https://shogun-dev.xchangeboxng.com/api/v1/transaction/transfer/web/fetch_all_banks

Authentication

Include your Bearer token in the Authorization header:

Authorization: Bearer <access_token>

Obtain a token by logging in via User Login.

Request body

No request body is required for this endpoint.

Example request

curl --request POST \
  --url https://baasapi.payrepmfb.com/api/v1/transaction/transfer/web/fetch_all_banks \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json'

Response

A successful response returns the standard envelope with an array of bank objects in data.

status · boolean

true when the request succeeded.

response_code · string

"00" on success.

message · string

Human-readable status message.

data · array

An array of bank objects representing all supported Nigerian banks.

Show Bank object

bank_name · string

The full registered name of the bank (e.g., "Guaranty Trust Bank").

bank_code · string

The 3-digit NIP bank code used in transfer and name enquiry requests (e.g., "058").

{
  "status": true,
  "response_code": "00",
  "message": "Banks fetched successfully",
  "data": [
    {
      "bank_name": "Access Bank",
      "bank_code": "044"
    },
    {
      "bank_name": "Guaranty Trust Bank",
      "bank_code": "058"
    },
    {
      "bank_name": "United Bank for Africa",
      "bank_code": "033"
    }
  ]
}

Error codes

Code	Meaning
00	Success
41	Customer not found — your session token is invalid or expired
80	Service unavailable — the bank list could not be retrieved at this time