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

# Get onboarding bank accounts

> Retrieves bank accounts for onboarding process



## OpenAPI

````yaml /openapi.yaml post /ramp/onboarding/bank-accounts
openapi: 3.1.0
info:
  title: FX API
  version: 1.0.0
  description: >
    API for managing FX operations including onboarding, quotes, orders, and
    customer management.

    This API provides endpoints for managing customers, bank accounts, crypto
    wallets, orders, and webhooks.
servers:
  - url: https://api.etherfuse.com
    description: Production API
  - url: https://api.sand.etherfuse.com
    description: Sandbox API (for testing)
security: []
tags:
  - name: Lookup
    description: Public endpoints for looking up stablebond and exchange rate data
  - name: Assets
    description: Get available assets for ramping
  - name: Onboarding
    description: Customer onboarding and KYC
  - name: Bank Accounts
    description: Manage customer bank accounts
  - name: Agreements
    description: Handle customer agreements and consents
  - name: Quotes
    description: Get quotes for conversions
  - name: Orders
    description: Create and manage orders
  - name: Swaps
    description: Create and manage swaps
  - name: Customers
    description: Manage customers
  - name: Crypto Wallets
    description: Manage crypto wallets
  - name: Webhooks
    description: Manage webhook subscriptions
  - name: Organizations
    description: Manage organizations and child organizations
paths:
  /ramp/onboarding/bank-accounts:
    post:
      tags:
        - Onboarding
      summary: Get onboarding bank accounts
      description: Retrieves bank accounts for onboarding process
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PresignedUrlPayload'
      responses:
        '200':
          description: Bank accounts retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  bankAccounts:
                    type: array
                    items:
                      $ref: '#/components/schemas/BankAccount'
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    PresignedUrlPayload:
      type: object
      description: >
        Payload containing a presigned URL for user authentication.

        The presigned URL serves as the authentication mechanism for the end
        user and contains

        cryptographically signed claims (customer ID, wallet public key,
        organization ID).
      properties:
        presignedUrl:
          type: string
          description: >
            Presigned URL obtained from `POST /ramp/onboarding-url`. This URL
            authenticates

            the end user and authorizes actions on their behalf.
      required:
        - presignedUrl
      example:
        presignedUrl: https://devnet.etherfuse.com/onboarding?token=eyJhbGciOiJIUzI1NiIs...
    BankAccount:
      type: object
      properties:
        bankAccountId:
          type: string
          format: uuid
          description: Unique identifier for the bank account. Must be a valid UUID v4.
        customerId:
          type: string
          format: uuid
          description: ID of the customer who owns this bank account
        createdAt:
          type: string
          format: date-time
          description: Timestamp when the bank account was created
        updatedAt:
          type: string
          format: date-time
          description: Timestamp when the bank account was last updated
        deletedAt:
          type: string
          format: date-time
          nullable: true
          description: Timestamp when the bank account was deleted (if applicable)
        abbrClabe:
          type: string
          description: Abbreviated CLABE number for the bank account
        etherfuseDepositClabe:
          type: string
          nullable: true
          description: Etherfuse deposit CLABE number
        label:
          type: string
          nullable: true
          description: Custom label for the bank account
        compliant:
          type: boolean
          description: >-
            Whether the bank account is compliant. This is a derived value —
            true if the account has been explicitly marked compliant OR if the
            owning organization is approved (KYB'd).
        status:
          type: string
          enum:
            - pending
            - awaitingDepositVerification
            - active
            - inactive
          description: Current status of the bank account
      example:
        bankAccountId: 123e4567-e89b-12d3-a456-426614174000
        customerId: 123e4567-e89b-12d3-a456-426614174001
        createdAt: '2024-01-01T00:00:00Z'
        updatedAt: '2024-01-01T00:00:00Z'
        abbrClabe: 1234...5678
        compliant: true
        status: active
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
      example:
        error: Invalid request parameters

````