---
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
- TypeScript: <https://skmtc.dev/hifibridge/apis/hifi-api/docs/v2/users/:userId/virtual-accounts/:accountId/get.ts> (a function with typed inputs; its response is checked against the schema)

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'
  - `microDeposits` object
    - `count` integer
    - `data` object[]
      - `createdAt` string, date-time
      - `currency` string
      - `amount` integer
      - `sourceBankInfo` InboundObject
        - `bankName` string
        - `senderName` string
        - `routingNumber` string
        - `accountNumber` string
        - `accountType` string
        - `fedBatchId` string
        - `imad` string
        - `omad` string
        - `traceNumber` string
        - `bankAddress` string
        - `description` string
        - `paymentRail` 'ach' | 'wire' | 'rtp'
  - `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

---

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