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

# List Bank Onramp Accounts

> Paginated list of reusable bank deposit accounts for the authenticated organization.



## OpenAPI

````yaml https://api.coinvoyage.io/v3/openapi.json get /onramp/bank/accounts
openapi: 3.1.0
info:
  title: CoinVoyage API (v3)
  description: >-
    CoinVoyage v3 payment API. Unified Intent envelope, snake_case money via the
    Amount shape, and a single SHA-256 signature scheme.
  version: 3.0.0
servers:
  - url: https://api.coinvoyage.io/v3
security: []
paths:
  /onramp/bank/accounts:
    get:
      tags:
        - onramps
      summary: List Bank Onramp Accounts
      description: >-
        Paginated list of reusable bank deposit accounts for the authenticated
        organization.
      operationId: listBankOnrampAccounts
      parameters:
        - description: API key for authentication
          in: header
          name: X-API-KEY
          required: true
          schema:
            type: string
        - in: query
          name: limit
          schema:
            default: 20
            maximum: 100
            minimum: 1
            type: integer
        - in: query
          name: offset
          schema:
            default: 0
            maximum: 100000
            minimum: 0
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankOnrampAccountListResponse'
          description: Bank onramp accounts with pagination
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Invalid limit or offset
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '502':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Onramp provider unavailable
      security:
        - APIKeyHeader: []
components:
  schemas:
    BankOnrampAccountListResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/BankOnrampAccount'
          type: array
        pagination:
          $ref: '#/components/schemas/Pagination'
      type: object
    ErrorResponse:
      example:
        code: 400
        error: Bad Request
        message: Invalid request parameters
      properties:
        error:
          example: Bad Request
          type: string
        message:
          example: Invalid request parameters
          type: string
        code:
          example: 400
          format: int64
          type: integer
        details:
          anyOf:
            - type: string
            - type: number
            - type: object
      required:
        - error
        - message
        - code
      type: object
    BankOnrampAccount:
      example:
        created_at: '2026-08-25T18:30:00Z'
        deposit_instructions:
          account_holder_name: CoinVoyage Customer
          account_number: '1234567890'
          bank_address: 1801 Main Street, Kansas City, MO 64108
          bank_beneficiary_address: 111 E 5th Avenue, San Mateo, CA 94401
          bank_beneficiary_name: Bridge Ventures Inc.
          bank_name: Lead Bank
          bic: COBADEFFXXX
          br_code: 00020126580014br.gov.bcb.pix0136example-key
          bre_b_key: CV123456789
          clabe: '646180157034181180'
          currency: usd
          deposit_message: CV-123456
          iban: DE89370400440532013000
          payment_rails:
            - wire
            - ach_push
          routing_number: '021000021'
          sort_code: '123456'
        destination:
          currency:
            address: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
            chain_id: 30000000000001
          wallet_address: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
        id: onramp_account_123
        source_currency: usd
        status: activated
        updated_at: '2026-08-25T18:30:05Z'
      properties:
        id:
          example: onramp_account_123
          type: string
        status:
          $ref: '#/components/schemas/BankOnrampAccountStatus'
        source_currency:
          $ref: '#/components/schemas/FiatCurrency'
          example: usd
        destination:
          $ref: '#/components/schemas/OnrampDestination'
        deposit_instructions:
          anyOf:
            - $ref: '#/components/schemas/OnrampDepositInstructions'
            - type: 'null'
        created_at:
          example: '2026-08-25T18:30:00Z'
          format: date-time
          type: string
        updated_at:
          example: '2026-08-25T18:30:05Z'
          format: date-time
          type: string
      required:
        - id
        - status
        - source_currency
        - destination
        - created_at
        - updated_at
      type: object
    Pagination:
      example:
        limit: 20
        offset: 0
        total_count: 42
      properties:
        total_count:
          example: 42
          format: int64
          type: integer
        limit:
          example: 20
          format: int64
          type: integer
        offset:
          example: 0
          format: int64
          type: integer
      required:
        - total_count
        - limit
        - offset
      type: object
    BankOnrampAccountStatus:
      description: Lifecycle of reusable bank deposit instructions
      enum:
        - pending
        - activated
        - deactivated
      type: string
    FiatCurrency:
      description: >-
        Fiat currency used by Bridge bank accounts and durable bank-onramp
        sessions
      enum:
        - usd
        - eur
        - mxn
        - brl
        - gbp
        - cop
      type: string
    OnrampDestination:
      example:
        currency:
          address: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
          chain_id: 30000000000001
        wallet_address: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
      properties:
        currency:
          $ref: '#/components/schemas/CurrencyBase'
        wallet_address:
          example: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
          type: string
      required:
        - currency
        - wallet_address
      type: object
    OnrampDepositInstructions:
      discriminator:
        propertyName: currency
      oneOf:
        - example:
            account_number: '1234567890'
            bank_address: 1801 Main Street, Kansas City, MO 64108
            bank_beneficiary_address: 111 E 5th Avenue, San Mateo, CA 94401
            bank_beneficiary_name: Bridge Ventures Inc.
            bank_name: Lead Bank
            currency: usd
            deposit_message: CV-123456
            payment_rails:
              - wire
              - ach_push
            routing_number: '021000021'
          properties:
            account_number:
              example: '1234567890'
              type: string
            bank_address:
              example: 1801 Main Street, Kansas City, MO 64108
              type: string
            bank_beneficiary_address:
              example: 111 E 5th Avenue, San Mateo, CA 94401
              type: string
            bank_beneficiary_name:
              example: Bridge Ventures Inc.
              type: string
            bank_name:
              example: Lead Bank
              type: string
            currency:
              enum:
                - usd
              example: usd
              type: string
            deposit_message:
              description: Required memo or reference to include with every bank transfer.
              example: CV-123456
              type: string
            payment_rails:
              example:
                - wire
                - ach_push
              items:
                type: string
              type: array
            routing_number:
              example: '021000021'
              type: string
          required:
            - currency
            - payment_rails
            - deposit_message
            - account_number
            - routing_number
          type: object
        - example:
            account_holder_name: CoinVoyage Customer
            bank_address: 1801 Main Street, Kansas City, MO 64108
            bank_name: Lead Bank
            bic: COBADEFFXXX
            currency: eur
            deposit_message: CV-123456
            iban: DE89370400440532013000
            payment_rails:
              - sepa
          properties:
            account_holder_name:
              example: CoinVoyage Customer
              type: string
            bank_address:
              example: 1801 Main Street, Kansas City, MO 64108
              type: string
            bank_name:
              example: Lead Bank
              type: string
            bic:
              example: COBADEFFXXX
              type: string
            currency:
              enum:
                - eur
              example: eur
              type: string
            deposit_message:
              description: Required memo or reference to include with every bank transfer.
              example: CV-123456
              type: string
            iban:
              example: DE89370400440532013000
              type: string
            payment_rails:
              example:
                - sepa
              items:
                type: string
              type: array
          required:
            - currency
            - payment_rails
            - deposit_message
            - iban
            - bic
          type: object
        - example:
            account_holder_name: CoinVoyage Customer
            clabe: '646180157034181180'
            currency: mxn
            deposit_message: CV-123456
            payment_rails:
              - spei
          properties:
            account_holder_name:
              example: CoinVoyage Customer
              type: string
            clabe:
              example: '646180157034181180'
              type: string
            currency:
              enum:
                - mxn
              example: mxn
              type: string
            deposit_message:
              description: Required memo or reference to include with every bank transfer.
              example: CV-123456
              type: string
            payment_rails:
              example:
                - spei
              items:
                type: string
              type: array
          required:
            - currency
            - payment_rails
            - deposit_message
            - clabe
          type: object
        - example:
            account_holder_name: CoinVoyage Customer
            br_code: 00020126580014br.gov.bcb.pix0136example-key
            currency: brl
            deposit_message: CV-123456
            payment_rails:
              - pix
          properties:
            account_holder_name:
              example: CoinVoyage Customer
              type: string
            br_code:
              example: 00020126580014br.gov.bcb.pix0136example-key
              type: string
            currency:
              enum:
                - brl
              example: brl
              type: string
            deposit_message:
              description: Required memo or reference to include with every bank transfer.
              example: CV-123456
              type: string
            payment_rails:
              example:
                - pix
              items:
                type: string
              type: array
          required:
            - currency
            - payment_rails
            - deposit_message
            - br_code
          type: object
        - example:
            account_holder_name: CoinVoyage Customer
            account_number: '1234567890'
            bank_address: 1801 Main Street, Kansas City, MO 64108
            bank_beneficiary_address: 111 E 5th Avenue, San Mateo, CA 94401
            bank_beneficiary_name: Bridge Ventures Inc.
            bank_name: Lead Bank
            currency: gbp
            deposit_message: CV-123456
            payment_rails:
              - faster_payments
            sort_code: '123456'
          properties:
            account_holder_name:
              example: CoinVoyage Customer
              type: string
            account_number:
              example: '1234567890'
              type: string
            bank_address:
              example: 1801 Main Street, Kansas City, MO 64108
              type: string
            bank_beneficiary_address:
              example: 111 E 5th Avenue, San Mateo, CA 94401
              type: string
            bank_beneficiary_name:
              example: Bridge Ventures Inc.
              type: string
            bank_name:
              example: Lead Bank
              type: string
            currency:
              enum:
                - gbp
              example: gbp
              type: string
            deposit_message:
              description: Required memo or reference to include with every bank transfer.
              example: CV-123456
              type: string
            payment_rails:
              example:
                - faster_payments
              items:
                type: string
              type: array
            sort_code:
              example: '123456'
              type: string
          required:
            - currency
            - payment_rails
            - deposit_message
            - account_number
            - sort_code
          type: object
        - example:
            account_holder_name: CoinVoyage Customer
            bre_b_key: CV123456789
            currency: cop
            deposit_message: CV-123456
            payment_rails:
              - bre_b
          properties:
            account_holder_name:
              example: CoinVoyage Customer
              type: string
            bre_b_key:
              example: CV123456789
              type: string
            currency:
              enum:
                - cop
              example: cop
              type: string
            deposit_message:
              description: Required memo or reference to include with every bank transfer.
              example: CV-123456
              type: string
            payment_rails:
              example:
                - bre_b
              items:
                type: string
              type: array
          required:
            - currency
            - payment_rails
            - deposit_message
            - bre_b_key
          type: object
    CurrencyBase:
      example:
        address: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        chain_id: 30000000000001
      properties:
        address:
          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
          type:
            - string
            - 'null'
        chain_id:
          $ref: '#/components/schemas/ChainID'
          example: 30000000000001
      required:
        - chain_id
      type: object
    ChainID:
      enum:
        - 1
        - 10
        - 56
        - 137
        - 4663
        - 8453
        - 42161
        - 20000000000001
        - 30000000000001
        - 30000000000002
      example: 1
      format: int64
      type: integer
  securitySchemes:
    APIKeyHeader:
      in: header
      name: X-API-KEY
      type: apiKey

````