Skip to main content

BankListQuery

Overview​

Retrieves all banks configured in the system with their mandate and transfer capability flags. Used to populate bank selection dropdowns when setting up mandates, collection accounts, and disbursement targets.

Command Structure​

{
  "cmd": "BankListQuery",
  "data": "{}"
}

Parameters​

No parameters required.

Response​

{
  "ok": true,
  "statusCode": "00",
  "message": "Banks retrieved successfully.",
  "outData": [
    {
      "BankCode": "058",
      "BankName": "Guaranty Trust Bank",
      "AllowNibssMandate": true,
      "AllowRemita": true,
      "AllowNipTTransfer": true
    },
    {
      "BankCode": "011",
      "BankName": "First Bank of Nigeria",
      "AllowNibssMandate": true,
      "AllowRemita": false,
      "AllowNipTTransfer": true
    }
  ]
}

Response Fields​

FieldDescription
BankCodeBank sort code / NIBSS bank code
BankNameBank display name
AllowNibssMandateWhether NIBSS mandate can be set up on this bank
AllowRemitaWhether Remita direct debit is supported
AllowNipTTransferWhether NIP transfer (interbank) is supported