BVbvnk
Fiat Payments

Get wallet

Changed on

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 or Channels.

get/ledger/v2/wallets/{id}

Request

Path parameters

idstring required
Example:a:25031472839104:kR7mHxQ:1

The wallet identifier.

Response

OK

idstring required

The wallet identifier.

namestring required

Display name of the wallet.

status'ACTIVE' | 'INACTIVE' | 'TERMINATED' required

Status of the wallet.

createdAtstring date-time

Timestamp when the wallet was created in ISO 8601 format.

updatedAtstring date-time

Timestamp of the most recent update to the wallet in ISO 8601 format.

Example response

{
  "id": "a:25031472839104:kR7mHxQ:1",
  "name": "USD Operations",
  "status": "ACTIVE",
  "balance": {
    "currency": "USD"
  },
  "paymentInstruments": [
    {
      "accountHolderName": "System Pay Services (Malta) Limited",
      "accountHolderAddress": {
        "addressLine1": "123 Main Street",
        "city": "New York",
        "country": "GB",
        "stateCode": "NY",
        "postCode": "EC2R 8EJ"
      },
      "accountNumber": "DE10601202004579784373",
      "remittanceInformationPrefix": "REF FKGA983",
      "bankDetails": {
        "name": "Banco Europa Continental, S.A.",
        "address": {
          "addressLine1": "123 Main Street",
          "city": "New York",
          "country": "GB",
          "stateCode": "NY",
          "postCode": "EC2R 8EJ"
        },
        "bic": "SAPYGB2L",
        "nid": {
          "value": "601613",
          "type": "SORT_CODE"
        }
      }
    }
  ],
  "createdAt": "2025-02-13T22:55:56.104Z",
  "updatedAt": "2026-05-08T14:40:07.463Z"
}

Changes

  • c386d436bf2cRevision changes
    • breaking

      the response property /// became nullable for the status

    • breaking

      removed the required property /// from the response with the status

    • warning

      added the new ALGORAND enum value to the /// response property for the response status

    • warning

      added the new ARBITRUM enum value to the /// response property for the response status

    • warning

      added the new ARC enum value to the /// response property for the response status

    • warning

      added the new BASE enum value to the /// response property for the response status

    • warning

      added the new BINANCE enum value to the /// response property for the response status

    • warning

      added the new BITCOIN enum value to the /// response property for the response status

    • warning

      added the new BITCOIN_CASH enum value to the /// response property for the response status

    • warning

      added the new CARDANO enum value to the /// response property for the response status

    • warning

      added the new DOGECOIN enum value to the /// response property for the response status

    • warning

      added the new ETHEREUM enum value to the /// response property for the response status

    • warning

      added the new LITECOIN enum value to the /// response property for the response status

    • warning

      added the new POLYGON enum value to the /// response property for the response status

    • warning

      added the new RIPPLE enum value to the /// response property for the response status

    • warning

      added the new SOLANA enum value to the /// response property for the response status

    • warning

      added the new TRON enum value to the /// response property for the response status

  • 97d6c0d2fe2eRevision changes
    • info

      endpoint added