> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bullring.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Banks by Currency

> Retrieves a list of supported banks for a given currency.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/ramp/banking/banks/{currency}
openapi: 3.0.0
info:
  title: Bullring Finance API
  description: >-
    The Bullring Finance API allows you to build powerful cross-border payment
    solutions.
  version: 1.0.0
servers:
  - url: https://api.bullring.finance
    description: Production Server
  - url: https://staging-api.bullring.finance
    description: Sandbox Server
security:
  - x-api-key: []
tags:
  - name: Subaccounts
    description: Operations related to user subaccounts.
  - name: Verification
    description: Endpoints for subaccount verification, including KYC and KYB processes.
  - name: Balances
    description: Endpoints for retrieving account balances.
  - name: Deposits
    description: Endpoints for handling deposits into subaccounts.
  - name: Recipients
    description: Manage payment recipients for withdrawals.
  - name: Withdrawals
    description: Endpoints for handling withdrawals from subaccounts.
  - name: Conversions
    description: Endpoints for currency conversions.
  - name: Rates
    description: Endpoints for currency conversion rates.
  - name: Fees
    description: Endpoints for checking transaction fees.
  - name: Offramp
    description: Endpoints for handling offramp operations.
  - name: Onramp
    description: Endpoints for handling onramp operations.
paths:
  /v1/ramp/banking/banks/{currency}:
    get:
      tags:
        - Recipients
      summary: Get Banks by Currency
      description: Retrieves a list of supported banks for a given currency.
      parameters:
        - name: currency
          in: path
          required: true
          description: 'The currency to get the banks for. Supported currencies: BRL, NGN'
          schema:
            type: string
            enum:
              - BRL
              - NGN
      responses:
        '200':
          description: A list of banks
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                    code:
                      type: string
              example:
                - name: 3Line Card Management Limited
                  code: '800'
                - name: 78 FINANCE COMPANY LIMITED (BANK78)
                  code: '245'
                - name: 9 Payment Service Bank
                  code: '825'
                - name: 9 Payment Service Bank (9PSB)
                  code: '242'
                - name: Aaa Finance
                  code: '268'
                - name: Abbey Mortgage Bank
                  code: '293'
                - name: AB Microfinance Bank
                  code: '423'
                - name: Above Only Microfinance Bank
                  code: '413'
                - name: Abucoop  Microfinance Bank
                  code: '544'
                - name: Abulesoro Microfinance Bank Ltd
                  code: '659'
                - name: ABU Microfinance Bank
                  code: '402'
                - name: Accelerex Network
                  code: '405'
                - name: Access Bank
                  code: '262'
                - name: Access Bank Nigeria Plc
                  code: '227'
                - name: Access Bank Nigeria Plc
                  code: '237'
                - name: AccessMobile
                  code: '769'
                - name: Accion Microfinance Bank
                  code: '342'
                - name: Ada Microfinance Bank
                  code: '599'
                - name: Addosser Microfinance Bank
                  code: '368'
                - name: Adeyemi College Staff Microfinance Bank
                  code: '421'
                - name: ADVANCLY MFB
                  code: '847'
                - name: Afekhafe Microfinance Bank
                  code: '443'
                - name: Afemai Microfinance Bank
                  code: '634'
                - name: AG Mortgage Bank
                  code: '784'
                - name: Agosasa Microfinance Bank
                  code: '498'
                - name: Akpo Microfinance Bank
                  code: '712'
                - name: Akuchukwu Microfinance Bank Ltd
                  code: '675'
                - name: Aku Microfinance Bank
                  code: '646'
                - name: Akwa Savings & Loans Limited
                  code: '306'
                - name: ' AL-Barakah Microfinance Bank'
                  code: '341'
                - name: Alekun Microfinance Bank
                  code: '412'
                - name: Alert Microfinance Bank
                  code: '448'
                - name: Al-Hayat Microfinance Bank
                  code: '430'
                - name: Allworkers Microfinance Bank
                  code: '339'
                - name: Ally Microfinance Bank
                  code: '662'
                - name: Alpha Kapital Microfinance Bank
                  code: '377'
                - name: ALTERNATIVE BANK LIMITED
                  code: '256'
                - name: Alvana Microfinance Bank
                  code: '605'
                - name: Amac Microfinance Bank
                  code: '515'
                - name: AMJU Unique Microfinance Bank
                  code: '389'
                - name: AMML MFB
                  code: '324'
                - name: AMOYE MICROFINANCE BANK
                  code: '714'
                - name: AMPLE MFB
                  code: '853'
                - name: Anchorage Microfinance Bank
                  code: '592'
                - name: Aniocha Microfinance Bank
                  code: '585'
                - name: Apeks Microfinance Bank
                  code: '351'
                - name: APEX TRUST MFB
                  code: '749'
                - name: Apple  Microfinance Bank
                  code: '502'
                - name: Aramoko Microfinance Bank
                  code: '455'
                - name: Arca Payments
                  code: '806'
                - name: Arise Microfinance Bank
                  code: '435'
                - name: ASOSavings & Loans
                  code: '311'
                - name: Aspire Microfinance Bank Ltd
                  code: '658'
                - name: Assets Matrix Microfinance Bank
                  code: '439'
                - name: Assets Microfinance Bank
                  code: '589'
                - name: Astrapolaris Microfinance Bank
                  code: '380'
                - name: Atbu  Microfinance Bank
                  code: '569'
                - name: Auchi Microfinance Bank
                  code: '417'
                - name: AVE MARIA MICROFINANCE BANK LTD
                  code: '707'
                - name: Avuenegbe Microfinance Bank
                  code: '594'
                - name: Aztec Microfinance Bank
                  code: '654'
        '400':
          description: Invalid currency
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  timestamp:
                    type: string
                    format: date-time
                  path:
                    type: string
                  error:
                    type: string
                  message:
                    type: string
                  stack:
                    type: string
              example:
                statusCode: 400
                timestamp: '2025-12-30T10:20:52.254Z'
                error: Bad Request
                message: >-
                  Invalid currency. Supported currencies: MXN, BRL, COP, ARS,
                  NGN
components:
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````