> ## Documentation Index > Fetch the complete documentation index at: https://docs.breet.io/llms.txt > Use this file to discover all available pages before exploring further. # Fetch Bank List > Retrieve list of available banks ## OpenAPI ````yaml /api-reference/openapi.json get /payments/banks openapi: 3.0.0 info: title: BREET PUBLIC API version: 1.0.0 license: name: Proprietary url: https://breet.io/terms servers: - url: https://api.breet.io/v1 security: - appId: [] appSecret: [] breetEnv: [] tags: - name: Crypto Wallet description: Generate and manage crypto wallet addresses for receiving deposits. x-group: Wallets and Deposits - name: Withdrawals description: >- ## Withdrawals To help protect your funds, withdrawals support an additional security layer through **IP whitelisting**. ### IP Whitelisting When IP whitelisting is enabled, all withdrawal requests must originate from an approved IP address. Any withdrawal request coming from an IP not on the whitelist will be automatically blocked. You can add up to **7 IP addresses** from your dashboard. This feature is recommended for: - Production servers - Preventing unauthorized withdrawal attempts ### How it works - Enable IP whitelisting from your dashboard - Add up to 7 trusted IP addresses - Only requests from those IPs will be allowed to initiate withdrawals If IP whitelisting is disabled, withdrawals can be initiated from any IP address. - name: Banks description: List, validate, add, and remove bank accounts for fiat withdrawals. - name: Transactions description: Retrieve deposit and trade transaction history. - name: Webhooks description: >- Inspect and retry **outgoing** webhooks we send to your server (trade and withdrawal events). Requires an active integration with API access (VIP partners). For **incoming** payload shapes and verification, see the Webhooks guide in the Guides tab. - name: Assets description: >- Retrieve the list of supported deposit/sell assets and their configuration. - name: Rates and Prices description: >- Get live market prices and calculate conversion rates. These endpoints are public and do not require authentication. - name: Account description: Retrieve and update integration account details and preferences. - name: Testing description: Endpoints for testing your integration in development. - name: Conversion description: >- Convert between USD and local fiat (NGN | GHS). Available for both user and integration (business) flows. - name: Wallet addresses description: >- Add and remove withdrawal (payout) wallet addresses. If the same address, network, and token are sent with a different label, the existing address is updated. paths: /payments/banks: get: tags: - Banks summary: Fetch Bank List description: Retrieve list of available banks operationId: fetchBankList parameters: - name: currency in: query schema: type: string description: ngn or ghs example: ngn responses: '200': description: List of supported banks returned successfully content: application/json: example: message: data fetched success: true data: - id: '0' hasLogo: true name: Abbey Mortgage Bank slug: abbey-mortgage-bank redbillerCode: '070010' anchorCode: '070010' monnifyCode: '801' palmpayCode: '070010' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/0.png - id: '1' hasLogo: true name: Access Bank slug: access-bank redbillerCode: '000014' anchorCode: '000014' monnifyCode: '044' palmpayCode: '000014' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/1.png - id: '2' hasLogo: true name: ASO Savings and Loans slug: asosavings redbillerCode: '090001' anchorCode: '090001' monnifyCode: '905' palmpayCode: '090001' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/2.png - id: '3' hasLogo: true name: Bowen Microfinance Bank slug: bowen-microfinance-bank redbillerCode: '090148' anchorCode: '090148' monnifyCode: '50931' palmpayCode: '090148' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/3.png - id: '4' hasLogo: true name: Carbon slug: carbon redbillerCode: '100026' anchorCode: '100026' monnifyCode: '940' palmpayCode: '100026' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/4.png - id: '5' hasLogo: true name: CEMCS Microfinance Bank slug: cemcs-microfinance-bank redbillerCode: '090154' anchorCode: '090154' monnifyCode: '50823' palmpayCode: '090154' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/5.png - id: '6' hasLogo: true name: Citibank Nigeria slug: citibank-nigeria redbillerCode: '000009' anchorCode: '000009' monnifyCode: '023' palmpayCode: '000009' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/6.png - id: '7' hasLogo: true name: Coronation Merchant Bank slug: coronation-merchant-bank redbillerCode: '060001' anchorCode: '060001' monnifyCode: '559' palmpayCode: '060001' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/7.png - id: '8' hasLogo: true name: Ecobank Nigeria slug: ecobank-nigeria redbillerCode: '000010' anchorCode: '000010' monnifyCode: '050' palmpayCode: '000010' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/8.png - id: '9' hasLogo: true name: Ekondo Microfinance Bank slug: ekondo-microfinance-bank redbillerCode: '090097' anchorCode: '090097' monnifyCode: '090097' palmpayCode: '090097' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/9.png - id: '10' hasLogo: true name: Eyowo slug: eyowo redbillerCode: '090328' anchorCode: '090328' monnifyCode: '50126' palmpayCode: '090328' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/10.png - id: '11' hasLogo: true name: Fidelity Bank slug: fidelity-bank redbillerCode: '000007' anchorCode: '000007' monnifyCode: '070' palmpayCode: '000007' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/11.png - id: '12' hasLogo: true name: First Bank of Nigeria slug: first-bank-of-nigeria redbillerCode: '000016' anchorCode: '000016' monnifyCode: '011' palmpayCode: '000016' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/12.png - id: '13' hasLogo: true name: First City Monument Bank slug: first-city-monument-bank redbillerCode: '000003' anchorCode: '000003' monnifyCode: '214' palmpayCode: '000003' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/13.png - id: '14' hasLogo: true name: FSDH Merchant Bank Limited slug: fsdh-merchant-bank-limited redbillerCode: '400001' anchorCode: '400001' monnifyCode: '400001' palmpayCode: '400001' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/14.png - id: '15' hasLogo: true name: Guaranty Trust Bank slug: guaranty-trust-bank redbillerCode: '000013' anchorCode: '000013' monnifyCode: '058' palmpayCode: '000013' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/15.png - id: '16' hasLogo: true name: Hackman Microfinance Bank slug: hackman-microfinance-bank redbillerCode: '090147' anchorCode: '090147' monnifyCode: '51251' palmpayCode: '090147' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/16.png - id: '17' hasLogo: true name: Hasal Microfinance Bank slug: hasal-microfinance-bank redbillerCode: '090121' anchorCode: '090121' monnifyCode: '50383' palmpayCode: '090121' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/17.png - id: '18' hasLogo: true name: Heritage Bank slug: heritage-bank redbillerCode: '000020' anchorCode: '000020' monnifyCode: '030' palmpayCode: '000020' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/18.png - id: '19' hasLogo: true name: Ibile Microfinance Bank slug: ibile-mfb redbillerCode: '090118' anchorCode: '090118' monnifyCode: '51244' palmpayCode: '090118' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/19.png - id: '20' hasLogo: true name: Infinity MFB slug: infinity-mfb redbillerCode: '090157' anchorCode: '090157' monnifyCode: '50457' palmpayCode: '090157' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/20.png - id: '21' hasLogo: true name: Jaiz Bank slug: jaiz-bank redbillerCode: '000006' anchorCode: '000006' monnifyCode: '301' palmpayCode: '000006' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/21.png - id: '22' hasLogo: true name: Keystone Bank slug: keystone-bank redbillerCode: '000002' anchorCode: '000002' monnifyCode: '082' palmpayCode: '000002' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/22.png - id: '23' hasLogo: true name: Kuda Bank slug: kuda-bank redbillerCode: '090267' anchorCode: '090267' monnifyCode: '50211' palmpayCode: '090267' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/23.png - id: '24' hasLogo: true name: Moniepoint MFB slug: moniepoint-mfb redbillerCode: '090405' anchorCode: '090405' monnifyCode: '090405' palmpayCode: '090405' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/24.png - id: '25' hasLogo: true name: OPay - Paycom slug: paycom redbillerCode: '100004' anchorCode: '100004' monnifyCode: '305' palmpayCode: '100004' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/25.png - id: '26' hasLogo: true name: PalmPay slug: palmpay redbillerCode: '100033' anchorCode: '100033' monnifyCode: '100033' palmpayCode: '100033' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/26.png - id: '28' hasLogo: true name: Petra Mircofinance Bank Plc slug: petra-microfinance-bank-plc redbillerCode: '090165' anchorCode: '90165' monnifyCode: '50746' palmpayCode: '090165' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/28.png - id: '29' hasLogo: true name: Polaris Bank slug: polaris-bank redbillerCode: '000008' anchorCode: '000008' monnifyCode: '076' palmpayCode: '000008' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/29.png - id: '30' hasLogo: true name: Providus Bank slug: providus-bank redbillerCode: '000023' anchorCode: '000023' monnifyCode: '101' palmpayCode: '000023' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/30.png - id: '31' hasLogo: true name: Rand Merchant Bank slug: rand-merchant-bank redbillerCode: '000024' anchorCode: '000024' monnifyCode: '502' palmpayCode: '000024' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/31.png - id: '33' hasLogo: true name: Stanbic IBTC Bank slug: stanbic-ibtc-bank redbillerCode: '000012' anchorCode: '000012' monnifyCode: '221' palmpayCode: '000012' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/33.png - id: '34' hasLogo: true name: Standard Chartered Bank slug: standard-chartered-bank redbillerCode: '000021' anchorCode: '000021' monnifyCode: '068' palmpayCode: '000021' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/34.png - id: '35' hasLogo: true name: Sterling Bank slug: sterling-bank redbillerCode: '000001' anchorCode: '000001' monnifyCode: '232' palmpayCode: '000001' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/35.png - id: '36' hasLogo: true name: Suntrust Bank slug: suntrust-bank redbillerCode: '000022' anchorCode: '000022' monnifyCode: '100' palmpayCode: '000022' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/36.png - id: '37' hasLogo: true name: TCF MFB slug: tcf-mfb redbillerCode: '090115' anchorCode: '090115' monnifyCode: '51211' palmpayCode: '090115' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/37.png - id: '38' hasLogo: true name: Union Bank of Nigeria slug: union-bank-of-nigeria redbillerCode: '000018' anchorCode: '000018' monnifyCode: '032' palmpayCode: '000018' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/38.png - id: '39' hasLogo: true name: United Bank For Africa slug: united-bank-for-africa redbillerCode: '000004' anchorCode: '000004' monnifyCode: '033' palmpayCode: '000004' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/39.png - id: '40' hasLogo: true name: Unity Bank slug: unity-bank redbillerCode: '000011' anchorCode: '000011' monnifyCode: '215' palmpayCode: '000011' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/40.png - id: '41' hasLogo: true name: VFD Microfinance Bank Limited slug: vfd redbillerCode: '090110' anchorCode: '090110' monnifyCode: '566' palmpayCode: '090110' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/41.png - id: '42' hasLogo: true name: Wema Bank slug: wema-bank redbillerCode: '000017' anchorCode: '000017' monnifyCode: '035' palmpayCode: '000017' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/42.png - id: '43' hasLogo: true name: Zenith Bank slug: zenith-bank redbillerCode: '000015' anchorCode: '000015' monnifyCode: '057' palmpayCode: '000015' country: Nigeria currency: NGN type: nuban avatar: https://assets.breet.io/dev/banks/ngn/43.png meta: {} summary: {} stats: {} '401': $ref: '#/components/responses/Unauthorized' '422': $ref: '#/components/responses/ValidationError' '500': $ref: '#/components/responses/InternalServerError' components: responses: Unauthorized: description: Invalid or missing API credentials content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: notAuthenticated: summary: Missing credentials value: success: false message: you're not authenticated meta: {} errors: [] data: {} wrongCredentials: summary: Invalid app ID or secret value: success: false message: wrong app id and secret combination meta: {} errors: [] data: {} ValidationError: description: >- Request validation failed — check the errors array for field-level details content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false message: validation errors meta: {} errors: - message: Invalid value field: amount location: body data: {} InternalServerError: description: An unexpected server error occurred content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false message: something went wrong! meta: {} errors: [] data: {} schemas: ErrorResponse: type: object required: - success - message properties: success: type: boolean enum: - false message: type: string meta: type: object errors: type: array items: type: object data: type: object securitySchemes: appId: type: apiKey in: header name: x-app-id description: Your application ID from the Breet dashboard appSecret: type: apiKey in: header name: x-app-secret description: Your application secret from the Breet dashboard breetEnv: type: apiKey in: header name: X-Breet-Env description: 'Environment selector: development or production' ````