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

# Retrieve an account

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

## Request

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

Get an existing onramp or offramp account detail.

## Path parameters

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

## Response `200`

Success

- union
  - AccountObject
    - `accountId` string
    - `userId` string
    - `createdAt` string, date-time
    - `accountType` string
    - `accountNumber` string
    - `routingNumber` string
    - `bankName` string
    - `isValid` boolean
    - `reason` string
    - `rail` object
      - `currency` string
      - `railType` string
      - `paymentRail` string
  - UsAccountObject
    - `id` string: Account ID
    - `userId` string: User ID
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `accountHolder` UsAccountHolder
      - `type` 'individual' | 'business', required
      - `name` string, required: The name of the account holder. `individual`: first name and last name seperated by space. `business`: legal name of the business.
      - `address` Address, required
        - `addressLine1` string, required
        - `addressLine2` string
        - `city` string, required
        - `stateProvinceRegion` string, required: The second part of the [ISO 3166-2 subdivision code](https://en.wikipedia.org/wiki/ISO_3166-2). This must be provided if the country has subdivisions. An ISO 3166-2 code consists of two parts, separated by a hyphen (`-`): 1. The first part is the ISO 3166-1 alpha-2 code of the country (e.g., `US`, `CA`, `BR`); 2. The second part is a string of up to three alphanumeric characters representing a specific subdivision (e.g., state, province). This is typically based on national standards or developed by ISO. Only provide the second part of the code (e.g., `CA` for California in `US-CA`, or `SP` for São Paulo in `BR-SP`).
        - `postalCode` string, required: Must be supplied for countries that use postal codes.
        - `country` string, required: Three-letter alpha-3 country code as defined in the [ISO 3166-1 spec](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3).
      - `isFintech` boolean: Whether the business account is a fintech.
    - `isValid` boolean: Indicates if the account is valid
    - `reason` string: Reason for invalidity, if applicable
    - `us` object
      - `accountType` 'Checking' | 'Savings': The type of account.
      - `accountNumber` string: The account number of the account.
      - `routingNumber` string: The routing number of the account.
      - `iban` string: Only one of `accountNumber` or `iban` can be provided.
      - `swiftCode` string: The SWIFT code of the bank where the account is held. Required if `transferType` is `swift`.
      - `bankName` string: The name of the bank where the account is held.
      - `bankAddress` Address
        - `addressLine1` string, required
        - `addressLine2` string
        - `city` string, required
        - `stateProvinceRegion` string, required: The second part of the [ISO 3166-2 subdivision code](https://en.wikipedia.org/wiki/ISO_3166-2). This must be provided if the country has subdivisions. An ISO 3166-2 code consists of two parts, separated by a hyphen (`-`): 1. The first part is the ISO 3166-1 alpha-2 code of the country (e.g., `US`, `CA`, `BR`); 2. The second part is a string of up to three alphanumeric characters representing a specific subdivision (e.g., state, province). This is typically based on national standards or developed by ISO. Only provide the second part of the code (e.g., `CA` for California in `US-CA`, or `SP` for São Paulo in `BR-SP`).
        - `postalCode` string, required: Must be supplied for countries that use postal codes.
        - `country` string, required: Three-letter alpha-3 country code as defined in the [ISO 3166-1 spec](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3).
      - `currency` 'usd': The currency of the account.
    - `rail` object
      - `currency` 'usd': The currency of the account.
      - `railType` 'offramp'
      - `paymentRail` string

## Other responses

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

---

[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)