BVbvnk
Fiat Payments

List customer's fiat wallets

Changed on

Retrieves a list of wallets for your customers.

• Without parameters: Returns all wallets associated with all your customers.

• With customerReference parameter: Returns wallets for a specific customer only. Usage: https://api.bvnk.com/ledger/v1/wallets?customerReference=550e8400-e29b-41d4-a716-446655440000 .

Deprecated: use GET /ledger/v2/wallets instead.

get/ledger/v1/wallets

Request

Query parameters

currencyCode'USD' | 'EUR' | 'GBP' | 'USDT' | 'POL' | 'PYUSD' | 'BTC' | 'SOL' | 'BNB' | 'XRP' | 'ETH' | 'LTC' | 'USDC' | 'USDG' | 'TRX'
Example:GBP

The currency code for the wallet.

customerReferencestring uuid
Example:33e85982-e22b-4e8b-9057-445cf000bea9

Reference to the customer who owns the wallet.

pageinteger

Page number for pagination. Starts from 0.

sizeinteger

Number of items to return per page.

sortstring
Example:currencyCode,desc

Sorting criteria in the format property,<asc/desc>. Default sort order is asc.

offsetinteger

Starting point for pagination, used instead of `page. Useful for cursor-based pagination.

Response

OK

totalPagesinteger

The total number of available pages

totalElementsinteger

The total number of elements across all pages

numberOfElementsinteger

The number of elements in the current page

lastboolean

Whether this is the last page

firstboolean

Whether this is the first page

emptyboolean

Whether the page contains no elements

Example response

{
  "content": [
    {
      "id": "a:24092328494070:G5i4XZ9:1",
      "accountReference": "3399c975-e1c1-4acf-9a90-6cfbdcdeaaea",
      "customerReference": "b94dcf2a-d377-469e-8846-e21f65b18a77",
      "name": "Wallet XYZ987",
      "status": "ACTIVE",
      "balance": {
        "value": 10,
        "currencyCode": "GBP"
      },
      "ledgers": [
        {
          "accountHolderName": "System Pay Services (Malta) Limited",
          "accountNumber": "DE10601202004579784373",
          "code": "BEUCESMMXXX",
          "accountNumberFormat": "SWIFT",
          "paymentReference": "REF DZ0XJL4",
          "bank": {
            "identificationCode": "BEUCESMMXXX",
            "name": "Banco Europa Continental, S.A.",
            "address": {
              "addressLine1": "123 Main St",
              "addressLine2": "Apt 4B",
              "region": "California",
              "city": "Los Angeles",
              "country": "US",
              "postCode": "90001"
            }
          }
        }
      ],
      "capabilities": "SAFEGUARDED"
    }
  ],
  "pageable": {
    "pageSize": 20
  },
  "totalPages": 3,
  "totalElements": 57,
  "numberOfElements": 20,
  "first": true
}

Changes