---
title: "Get fiat wallet"
method: GET
path: "/ledger/v1/wallets/{id}"
tags: ["Fiat Payments"]
deprecated: true
---

# Get fiat wallet

`GET /ledger/v1/wallets/{id}`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/ledger/v1/wallets/{id}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/ledger/v1/wallets/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

Retrieves a specific wallet by its ID.

**Deprecated:** use `GET /ledger/v2/wallets/{id}` instead.

## Path parameters

- `id` string, required

## Response `200`

OK

- WalletResponse
  - `id` string, required: Unique wallet ID.
  - `accountReference` string, uuid, required: Account reference for this wallet.
  - `customerReference` string, uuid, required: Customer reference for this wallet.
  - `name` string, required: Name of the wallet.
  - `status` 'ACTIVE' | 'INACTIVE' | 'TERMINATED', required: Status of the wallet.
  - `balance` Balance, required: Information about the available balance of the wallet.
    - `value` number, float, required: Available amount of funds in the wallet.
    - `currencyCode` 'USD' | 'EUR' | 'GBP' | 'USDT' | 'POL' | 'PYUSD' | 'BTC' | 'SOL' | 'BNB' | 'XRP' | 'ETH' | 'LTC' | 'USDC' | 'USDG' | 'TRX', required: Wallet currency.
  - `ledgers` Ledger[], required
    - union
      - FiatLedger: Information about the fiat ledger. If the wallet is enabled for SWIFT, the `paymentReference` is returned
        - `type` 'FIAT', required: Type of ledger, must be FIAT for this schema.
        - `accountHolderName` string: Name of the account holder.
        - `accountNumber` string, required: Account number. Must be provided only if `type` = `FIAT`.
        - `code` string, required: Bank identification code (BIC/SWIFT code).
        - `accountNumberFormat` string: Format of the account number.
        - `paymentReference` string: Reference to include with the payment.
        - `bank` object: Bank details associated with the fiat ledger.
          - `identificationCode` string: Bank identification code (BIC/SWIFT code).
          - `name` string: Name of the bank.
          - `address` Address
            - `addressLine1` string: Recipient's primary address line. Typically contains the street name and building number. Do not include the city, country, region/state, or postal code in this field; these values must be provided in their respective dedicated fields.
            - `addressLine2` string: Recipient's secondary address line. Typically contains additional details such as apartment, suite, or floor number. Do not include the city, country, region/state, or postal code in this field; these values must be provided in their respective dedicated fields.
            - `region` string: Recipient's state or region of the address.
            - `city` string: Recipient's city of the address.
            - `country` string, required: Recipient's country code.
            - `postCode` string: Postal or ZIP code of the recipient's address.
      - CryptoLedger
        - `type` 'CRYPTO', required: Type of ledger, must be CRYPTO for this schema.
        - `address` string, required: Crypto wallet address. Must be provided only if `type` = `CRYPTO`.
        - `network` string, required: Crypto wallet network or protocol. Must be provided only if `type` = `CRYPTO`.
        - `tag` string: Optional crypto tag or memo, if required by the network.
  - `capabilities` 'SAFEGUARDED': Flag that shows that funds or assets are protected and kept separate from a company's own money. They can't be used for business operations or debts and remain available to the rightful owners.

## Other responses

- `404`: Not found.

## Changes

- **2026-06-16** `97d6c0d2fe2e`: 1 breaking, 1 warning, 2 info
  - the `details/errors` response's property type changed from `object` to `array` for status `404`
  - removed the optional property `details/errors/requestBody` from the response with the `404` status
  - endpoint deprecated
  - added the required property `traceId` to the response with the `404` status

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/ledger/v1/wallets/:id/get.md)

---

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