---
title: "Retrieve a virtual account"
method: GET
path: "/v2/users/{userId}/virtual-accounts/{accountId}"
tags: ["Virtual Account"]
---

# Retrieve a virtual account

`GET /v2/users/{userId}/virtual-accounts/{accountId}`

## Request

- Base URL: `https://production.hifibridge.com`
- URL: `https://production.hifibridge.com/v2/users/{userId}/virtual-accounts/{accountId}`
- Auth: HTTP bearer

Get an existing virtual bank account detail.

## Path parameters

- `userId` string, required
- `accountId` string, required

## Query parameters

- `limit` string
- `createdBefore` string
- `createdAfter` string

## Response `200`

Success

- VirtualAccountObject
  - `id` string, uuid
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `userId` string, uuid
  - `source` object
    - `paymentRail` string[]
    - `currency` string
  - `destination` object
    - `chain` string
    - `currency` string
    - `walletAddress` string
    - `externalWalletId` string
  - `status` 'activated' | 'deactivated'
  - `maxBps` integer, nullable: Maximum USDT conversion fee, as a whole number of basis points from 0 through 10,000, allowed for automatic onramps through this virtual account. `null` means disabled.
  - `microDeposits` object
    - `count` integer
    - `data` object[]
      - `createdAt` string, date-time
      - `currency` string
      - `amount` string: Amount received, in dollars as a decimal string (for example `"0.71"`). Not cents.
      - `sourceBankInfo` InboundObject
        - `bankName` string, nullable
        - `senderName` string, nullable
        - `routingNumber` string, nullable
        - `accountNumber` string, nullable
        - `accountType` string, nullable: ACH field. `null` when the inbound payment did not carry it.
        - `fedBatchId` string, nullable: ACH field. `null` when the inbound payment did not carry it.
        - `imad` string, nullable: Fedwire input message identifier. `null` when the inbound payment did not carry it.
        - `omad` string, nullable: Fedwire output message identifier. `null` when the inbound payment did not carry it.
        - `traceNumber` string, nullable: Trace number for the inbound payment. `null` when the payment did not carry one.
        - `bankAddress` string, nullable
        - `description` string, nullable
        - `references` object, nullable: Remittance and reference information supplied by the sender. `null` when the payment carried none.
          - `senderReference` string, nullable
          - `beneficiaryReference` string, nullable
          - `remittance` string[]
        - `paymentRail` 'ach' | 'wire' | 'rtp', nullable
  - `depositInstructions` object
    - `bankName` string
    - `bankAddress` string
    - `swiftCode` string
    - `beneficiary` object
      - `name` string
      - `address` string
    - `ach` object
      - `routingNumber` string
      - `accountNumber` string
    - `wire` object
      - `routingNumber` string
      - `accountNumber` string
    - `rtp` object
      - `routingNumber` string
      - `accountNumber` string
    - `reference` string
    - `depositBy` string, date-time
    - `instruction` string
  - `settlementRuleId` string, uuid

## Other responses

- `401`: Unauthorized
- `404`: Resource not found
- `500`: Internal Server Error

## Changes

- **2026-11-03** `319fa6bd5bc6`: 13 breaking, 2 info
  - the response property `microDeposits/data/items/sourceBankInfo/accountNumber` became nullable for the status `200`
  - the response property `microDeposits/data/items/sourceBankInfo/accountType` became nullable for the status `200`
  - the response property `microDeposits/data/items/sourceBankInfo/bankAddress` became nullable for the status `200`
  - the response property `microDeposits/data/items/sourceBankInfo/bankName` became nullable for the status `200`
  - …11 more

[Operation history](https://skmtc.dev/hifi/apis/hifi-api/changes/v2/users/:userId/virtual-accounts/:accountId/get.md)

---

[API](https://skmtc.dev/hifi/apis/hifi-api.md) - [All operations](https://skmtc.dev/hifi/apis/hifi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hifi/apis/hifi-api/revisions/319fa6bd5bc6?raw)