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

# Get Virtual Account Details (Coming soon)

> Retrieve the full record for a single virtual account, including the deposit instructions the customer funds the account with and the crypto destination the deposits settle to.

<Warning>
  This endpoint is not available in production yet. It is documented so you can plan your
  integration ahead of release. Contact support for availability.
</Warning>


## OpenAPI

````yaml GET /v3/customers/{customer_id}/virtual-accounts/{va_id}
openapi: 3.1.0
info:
  title: Fin.com API
  version: 1.0.0
  description: >-
    A simple API specification for Fin.com, a financial services platform that
    provides a range of banking and payment solutions for businesses and
    individuals. This API allows developers to integrate Fin.com's services into
    their applications, enabling functionalities such as customer management,
    transaction processing, and access to financial data.
servers:
  - url: https://sandbox.api.fin.com
    description: Sandbox server
  - url: https://api.fin.com
    description: Production server
security: []
tags:
  - name: Authentication
    description: A modified OAuth 2.0 Client Credential Flow
  - name: Customers
    description: Customer management and document upload operations
  - name: Balances
    description: Retrieve wallet balance information
  - name: Catalogue
    description: |
      A set of endpoints to retrieve contextual data to assemble requests
      to fin.com's API
  - name: Beneficiaries
    description: Manage beneficiary accounts for payments and transfers
  - name: Transactions
    description: Transaction history and management for beneficiaries
  - name: Virtual Accounts
    description: Create and manage virtual accounts for USD to USDC conversions
  - name: Fees & FX Rates
    description: Retrieve fees and foreign exchange rates
paths:
  /v3/customers/{customer_id}/virtual-accounts/{va_id}:
    get:
      tags:
        - Virtual Accounts
      summary: Get Virtual Account Details (Coming soon)
      description: >-
        Retrieve the full record for a single virtual account, including the
        deposit instructions the customer funds the account with and the crypto
        destination the deposits settle to.
      operationId: getVirtualAccountDetailsV3
      parameters:
        - name: customer_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the customer the virtual account belongs to.
          example: c1f4a8e2-3b57-4d09-9a61-7e2b5c8d4f30
        - name: va_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the virtual account to retrieve.
          example: 9d2b7f41-6c8a-45e3-b071-2fa93c5e8d16
      responses:
        '200':
          description: Virtual account retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                        description: Unique identifier of the virtual account.
                        example: 9d2b7f41-6c8a-45e3-b071-2fa93c5e8d16
                      status:
                        type: string
                        enum:
                          - PROCESSING
                          - IN_COMPLIANCE
                          - REQUEST_FOR_INFORMATION
                          - ACTIVE
                          - INACTIVE
                          - DECLINED
                        description: >-
                          Current state of the virtual account.
                          `deposit_instructions` stays null until the banking
                          partner issues the account and the status becomes
                          `ACTIVE`.
                        example: ACTIVE
                      customer_id:
                        type: string
                        format: uuid
                        description: Customer the virtual account belongs to.
                        example: c1f4a8e2-3b57-4d09-9a61-7e2b5c8d4f30
                      developer_fee_percent:
                        type: number
                        nullable: true
                        description: Percentage fee applied on top of each deposit.
                        example: 0
                      developer_fee_fixed:
                        type: number
                        nullable: true
                        description: Fixed fee applied on top of each deposit.
                        example: 0
                      bank:
                        type: string
                        enum:
                          - SSB
                          - PORTAGE
                        description: Banking partner that issued the virtual account.
                        example: SSB
                      deposit_instructions:
                        type: object
                        nullable: true
                        description: >-
                          Bank details the customer deposits into. Null until
                          the banking partner issues the account.
                        properties:
                          currency:
                            type: string
                            description: Fiat currency the account accepts.
                            example: USD
                          bank_name:
                            type: string
                            example: Slovak Savings Bank
                          bank_address:
                            type: string
                            example: 500 Market Street, San Francisco, CA 94105
                          bank_routing_number:
                            type: string
                            example: '021000021'
                          bank_account_number:
                            type: string
                            example: '9876543210'
                          bank_beneficiary_name:
                            type: string
                            description: Name the deposit must be made out to.
                            example: Acme Trading Ltd
                          bank_beneficiary_address:
                            type: string
                            example: 12 Gulshan Avenue, Dhaka, BGD
                          bank_country:
                            type: string
                            description: Country of the receiving bank, ISO 3166-1 alpha-3.
                            example: USA
                          account_type:
                            type: string
                            example: CHECKING
                          payment_rails:
                            type: array
                            description: Fiat rails the account can be funded over.
                            items:
                              type: string
                              enum:
                                - ACH
                                - FEDWIRE
                                - SWIFT
                            example:
                              - ACH
                              - FEDWIRE
                              - SWIFT
                          bic_swift:
                            type: string
                            nullable: true
                            description: >-
                              BIC of the receiving bank. Used for SWIFT
                              deposits.
                            example: SUNBUS44XXX
                          bank_code:
                            type: object
                            nullable: true
                            description: National clearing code for the receiving bank.
                            properties:
                              type:
                                type: string
                                enum:
                                  - ACH
                                  - FEDWIRE
                                  - SWIFT
                                description: Code scheme the value in `code` belongs to.
                                example: SWIFT
                              code:
                                type: string
                                example: '021000021'
                      destination:
                        type: object
                        description: Crypto destination the deposits settle to.
                        properties:
                          currency:
                            type: string
                            enum:
                              - USDC
                            description: Token delivered to the destination wallet.
                            example: USDC
                          destination_chain:
                            type: string
                            enum:
                              - ETHEREUM
                              - POLYGON
                            description: Blockchain network the destination wallet is on.
                            example: ETHEREUM
                          address:
                            type: string
                            description: Destination wallet address.
                            example: '0x4E91c07aB35d2F6810b94Ce7d13A5f826c0D4b7E'
                      rfi:
                        type: object
                        nullable: true
                        description: >-
                          Populated only when the status is
                          `REQUEST_FOR_INFORMATION`.
                        example: null
                      created_at:
                        type: string
                        format: date-time
                        example: '2026-09-04T03:12:44Z'
                      updated_at:
                        type: string
                        format: date-time
                        example: '2026-09-04T03:13:10Z'
              examples:
                OK:
                  summary: OK
                  value:
                    data:
                      id: 9d2b7f41-6c8a-45e3-b071-2fa93c5e8d16
                      status: ACTIVE
                      customer_id: c1f4a8e2-3b57-4d09-9a61-7e2b5c8d4f30
                      developer_fee_percent: 0
                      developer_fee_fixed: 0
                      bank: SSB
                      deposit_instructions:
                        currency: USD
                        bank_name: Slovak Savings Bank
                        bank_address: 500 Market Street, San Francisco, CA 94105
                        bank_routing_number: '021000021'
                        bank_account_number: '9876543210'
                        bank_beneficiary_name: Acme Trading Ltd
                        bank_beneficiary_address: 12 Gulshan Avenue, Dhaka, BGD
                        bank_country: USA
                        account_type: CHECKING
                        payment_rails:
                          - SWIFT
                        bic_swift: GIBASKBXXXX
                        bank_code:
                          type: SWIFT
                          code: GIBASKBXXXX
                      destination:
                        currency: USDC
                        destination_chain: ETHEREUM
                        address: '0x4E91c07aB35d2F6810b94Ce7d13A5f826c0D4b7E'
                      rfi: null
                      created_at: '2026-09-04T03:12:44Z'
                      updated_at: '2026-09-04T03:13:10Z'
        '401':
          $ref: '#/components/responses/AuthenticationError'
        '422':
          $ref: '#/components/responses/ValidationError'
      security:
        - bearerAuth: []
components:
  responses:
    AuthenticationError:
      description: Authentication failed due to invalid credentials
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Authentication failed
    ValidationError:
      description: Failed due to a formatting error.
      content:
        application/json:
          schema:
            type: object
            required:
              - message
            properties:
              message:
                type: string
              errors:
                type: array
                items:
                  type: object
                  additionalProperties:
                    type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Bearer token authentication. Obtain token from [Issue a
        Token](https://developer.fin.com/api-reference/authentication/issue-a-token)
        endpoint

````