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

# Get wallet

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

## Request

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

Retrieves a single wallet by its ID. You can retrieve your own or your customer's wallet.

Payment instruments are returned for fiat wallets only. To receive crypto deposits into a wallet, generate a blockchain address using [Payment Links](/bvnk/use-cases/stablecoin-payments-for-platforms/get-payment) or [Channels](/bvnk/use-cases/stablecoin-payments-for-platforms/create-channel).

## Path parameters

- `id` string, required

## Response `200`

OK

- LedgerWalletV2Response
  - `id` string, required: The wallet identifier.
  - `name` string, required: Display name of the wallet.
  - `customer` LedgerWalletV2Customer: Customer with which this wallet is associated. Shown only for customer wallets.
    - `id` string, uuid: Unique identifier for the customer.
    - `name` string: Display name for the customer.
  - `status` 'ACTIVE' | 'INACTIVE' | 'TERMINATED', required: Status of the wallet.
  - `balance` object: Available balance for the wallet.
    - `amount` number, required: Balance amount as a decimal string for fixed precision.
    - `currency` string, required: Wallet currency code.
  - `paymentInstruments` union[]: Payment instruments associated with the wallet. Fiat wallets return bank account details, and self-custody wallets return the blockchain address on the wallet's network. Custodial crypto wallets return an empty array.
    - union
      - LedgerWalletV2FiatLedger: Information about the fiat payment instruments. When a payment reference is required for inbound payments, `remittanceInformationPrefix` indicates the required prefix (e.g. for SWIFT).
        - `type` 'FIAT', required: Type of ledger, must be FIAT for this schema.
        - `accountHolderName` string, required: Name of the account holder.
        - `accountHolderAddress` LedgerWalletV2BankAddress: Physical address of the bank.
          - `addressLine1` string: Primary street address line.
          - `addressLine2` string: Secondary address line (suite, floor, building, etc.).
          - `city` string: City of the bank address.
          - `country` string: ISO 3166-1 alpha-2 country code of the bank address.
          - `stateCode` string: ISO 3166-2 state or province code.
          - `postCode` string: Postal or ZIP code of the bank address.
          - `fullAddress` string: Full formatted address string.
        - `accountNumber` string, required: Account number. Must be provided only if `type` = `FIAT`.
        - `remittanceInformationPrefix` string: Prefix that must appear within the payment reference when a `reference` is required for this rail, for example, SWIFT.
        - `bankDetails` LedgerWalletV2Bank: Bank details associated with the fiat payment instrument.
          - `name` string, required: Name of the bank.
          - `address` LedgerWalletV2BankAddress: Physical address of the bank.
            - `addressLine1` string: Primary street address line.
            - `addressLine2` string: Secondary address line (suite, floor, building, etc.).
            - `city` string: City of the bank address.
            - `country` string: ISO 3166-1 alpha-2 country code of the bank address.
            - `stateCode` string: ISO 3166-2 state or province code.
            - `postCode` string: Postal or ZIP code of the bank address.
            - `fullAddress` string: Full formatted address string.
          - `bic` string, required: Bank Identifier Code (SWIFT/BIC).
          - `nid` LedgerWalletV2BankNid: National identifier for the bank. Present when a local clearing code applies.
            - `value` string, required: The national identifier value (e.g. routing number, sort code).
            - `type` 'ROUTING_NUMBER' | 'SORT_CODE' | 'OTHER': Type of the national identifier.
      - LedgerWalletV2CryptoLedger: Blockchain address of a self-custody wallet. Each self-custody wallet has one address on one network.
        - `address` string, required: Blockchain address to receive funds on the wallet's network.
        - `network` 'TRON' | 'ETHEREUM' | 'LITECOIN' | 'BITCOIN' | 'RIPPLE' | 'DOGECOIN' | 'SOLANA' | 'ALGORAND' | 'CARDANO' | 'BINANCE' | 'POLYGON' | 'BITCOIN_CASH' | 'ARC' | 'ARBITRUM' | 'BASE', required: Blockchain network.
        - `tag` string, nullable: Tag or memo for the address, if the network requires one.
  - `createdAt` string, date-time: Timestamp when the wallet was created in ISO 8601 format.
  - `updatedAt` string, date-time: Timestamp of the most recent update to the wallet in ISO 8601 format.

## Other responses

- `400`: Bad request.
- `403`: Forbidden.
- `404`: Not found.

## Changes

- **2026-11-06** `c386d436bf2c`: 2 breaking, 15 warning
  - the response property `paymentInstruments/items/oneOf[subschema #2: Crypto payment instruments]/tag` became nullable for the status `200`
  - removed the required property `paymentInstruments/items/oneOf[subschema #2: Crypto payment instruments]/type` from the response with the `200` status
  - added the new `ALGORAND` enum value to the `paymentInstruments/items/oneOf[subschema #2: Crypto payment instruments]/network` response property for the response status `200`
  - added the new `ARBITRUM` enum value to the `paymentInstruments/items/oneOf[subschema #2: Crypto payment instruments]/network` response property for the response status `200`
  - …13 more
- **2026-06-16** `97d6c0d2fe2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/ledger/v2/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)