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

# Get Account Details

> Returns the user's bank account details according to the specified country and currency. The details vary depending on the country and may include ACH account information (US), SEPA (EU), or local bank accounts. Currently only US and EU are supported in the public API.



## OpenAPI

````yaml GET /api/public/v1/account-details
openapi: 3.0.3
info:
  title: Wallbit Public API
  description: >-
    Wallbit Public API allows developers to integrate Wallbit functionality into
    their applications. Access account balances, view transaction history, and
    execute trades programmatically using API Keys.
  version: 1.0.0
  contact:
    name: Wallbit API Support
    email: dev@wallbit.io
servers:
  - url: https://api.wallbit.io
    description: Production server
  - url: http://localhost
    description: Local development server
security:
  - apiKey: []
tags:
  - name: Balance
    description: Endpoints to retrieve account balances
  - name: Transactions
    description: Endpoints to retrieve transaction history
  - name: Trades
    description: Endpoints to execute trading operations
  - name: Fees
    description: >-
      Endpoints to retrieve fee configuration for the authenticated user (e.g.
      stock trading fees by subscription tier)
  - name: Account Details
    description: Endpoints to obtain bank account details
  - name: Wallets
    description: Endpoints to obtain wallet addresses
  - name: Rates
    description: Endpoints to retrieve fiat exchange rates from Wallbit
  - name: Assets
    description: Endpoints to query information about assets (stocks) and categories
  - name: Operations
    description: Endpoints for deposit and withdrawal investment operations
  - name: Cards
    description: Endpoints to block and unblock cards
  - name: API Key
    description: Endpoints to revoke the API key used for authentication
paths:
  /api/public/v1/account-details:
    get:
      tags:
        - Account Details
      summary: Get bank account details
      description: >-
        Returns the user's bank account details according to the specified
        country and currency. The details vary depending on the country and may
        include ACH account information (US), SEPA (EU), or local bank accounts.
        Currently only US and EU are supported in the public API.
      operationId: getAccountDetails
      parameters:
        - name: country
          in: query
          description: Account country (US, EU)
          schema:
            type: string
            enum:
              - US
              - EU
            default: US
            example: US
        - name: currency
          in: query
          description: Account currency (USD, EUR)
          schema:
            type: string
            enum:
              - USD
              - EUR
            default: USD
            example: USD
      responses:
        '200':
          description: Account details retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/AccountDetails'
              examples:
                us-account:
                  summary: US Bank Account (ACH)
                  value:
                    data:
                      bank_name: Community Federal Savings Bank
                      currency: USD
                      account_type: CHECKING
                      account_number: '9876543210'
                      routing_number: '026073150'
                      swift_code: CTFNUS33
                      holder_name: John Doe
                      address:
                        street_line_1: 123 Main St
                        city: New York
                        state: NY
                        postal_code: '10001'
                        country: US
                eu-account:
                  summary: EU Bank Account (SEPA)
                  value:
                    data:
                      bank_name: Deutsche Bank
                      currency: EUR
                      account_type: CHECKING
                      iban: DE89370400440532013000
                      bic: COBADEFFXXX
                      holder_name: John Doe
                      address:
                        street_line_1: Hauptstraße 1
                        city: Berlin
                        postal_code: '10115'
                        country: DE
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          description: Validation error or account not verified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                not-verified:
                  summary: Account not verified
                  value:
                    message: Your checking account is not active or verified
                unsupported-country:
                  summary: Unsupported country
                  value:
                    message: >-
                      The public API currently only supports US and EU. For
                      other countries, please contact support.
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Could not retrieve bank account information.
      security:
        - apiKey: []
components:
  schemas:
    AccountDetails:
      type: object
      properties:
        bank_name:
          type: string
          description: Bank name
          example: Community Federal Savings Bank
        currency:
          type: string
          description: Account currency
          example: USD
        account_type:
          type: string
          description: Account type
          example: CHECKING
        account_number:
          type: string
          nullable: true
          description: Account number (for ACH)
          example: '9876543210'
        routing_number:
          type: string
          nullable: true
          description: Routing number (for ACH)
          example: '026073150'
        iban:
          type: string
          nullable: true
          description: IBAN (for SEPA)
          example: DE89370400440532013000
        bic:
          type: string
          nullable: true
          description: BIC/SWIFT code (for SEPA)
          example: COBADEFFXXX
        swift_code:
          type: string
          nullable: true
          description: SWIFT code
          example: CTFNUS33
        holder_name:
          type: string
          description: Account holder name
          example: John Doe
        beneficiary:
          type: string
          nullable: true
          description: Beneficiary name
          example: Wallbit Inc
        memo:
          type: string
          nullable: true
          description: Memo or additional instructions
        address:
          type: object
          nullable: true
          properties:
            street_line_1:
              type: string
              example: 123 Main St
            street_line_2:
              type: string
              nullable: true
            city:
              type: string
              example: New York
            state:
              type: string
              example: NY
            postal_code:
              type: string
              example: '10001'
            country:
              type: string
              example: US
    Error:
      type: object
      properties:
        message:
          type: string
          description: Error message
        error:
          type: string
          description: Error description
  responses:
    Unauthorized:
      description: Missing or invalid API Key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            missing:
              summary: Missing API Key
              value:
                message: API Key required. Please provide X-API-Key header.
            invalid:
              summary: Invalid API Key
              value:
                message: Invalid or expired API Key.
    Forbidden:
      description: Insufficient permissions
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              your_permissions:
                type: array
                items:
                  type: string
          example:
            message: 'Insufficient permissions. Required permission: read'
            your_permissions:
              - trade
    TooManyRequests:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              retry_after:
                type: integer
                description: Seconds until rate limit resets
          example:
            message: Too many requests. Please try again later.
            retry_after: 42
      headers:
        X-RateLimit-Limit:
          description: Total requests allowed per minute
          schema:
            type: integer
        X-RateLimit-Remaining:
          description: Requests remaining in current window
          schema:
            type: integer
        X-RateLimit-Reset:
          description: Unix timestamp when rate limit resets
          schema:
            type: integer
        Retry-After:
          description: Seconds to wait before retry
          schema:
            type: integer
  securitySchemes:
    apiKey:
      type: apiKey
      name: X-API-Key
      in: header
      description: >-
        API Key authentication. Obtain your API key from the Wallbit dashboard
        under Settings → API Keys.

````