Retrieve Customer Wallets
This endpoint allows you to retrieve all wallets associated with a specific Embedded Partner Customer, offering a detailed overview of their account.
The endpoint provides comprehensive information for each wallet, including status, balance, and other relevant details. This enables efficient monitoring and management of all payment channels linked to the customer, ensuring full operational visibility. You can list all wallets assigned to an Embedded Partner Customer and retrieve information for a specific wallet by providing its reference.
Retrieve all wallets
NoteThis endpoint includes pagination.
page: page number which starts from 0size: page size which limits the number of returned customers in the response
To list all the wallets associated with a specific EPC, send the GET /ledger/v1/wallets request.
In the response, you receive the detailed information on each wallet:
{
"content": [
{
"id": "a:25061762277338:4nJVWl1:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": "7e38e85f-8e1b-486d-b24f-28e4192f57f6",
"name": "Jonsal",
"status": "ACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "USD"
},
"ledgers": [
{
"type": "FIAT",
"accountHolderName": "Embedded Customer A",
"accountNumber": "900768107004",
"code": "101019644",
"accountNumberFormat": "ABA",
"paymentReference": null
}
]
},
{
"id": "a:25061762217894:7kqBQY6:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": "9ba4c65c-8c81-4e39-80b6-a803d9e66efd",
"name": "John Legend",
"status": "INACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "USD"
},
"ledgers": []
},
{
"id": "a:25061762124495:Sichkow:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": "9ba4c65c-8c81-4e39-80b6-a803d9e66efd",
"name": "USD",
"status": "INACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "USD"
},
"ledgers": []
},
{
"id": "a:25060450775603:v28lmzW:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": null,
"name": "Dave's Wallet",
"status": "ACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "EUR"
},
"ledgers": []
},
{
"id": "a:25052770895915:fQcLGMh:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": "7e38e85f-8e1b-486d-b24f-28e4192f57f6",
"name": "JL Wallet",
"status": "ACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "USD"
},
"ledgers": [
{
"type": "FIAT",
"accountHolderName": "Embedded Customer A",
"accountNumber": "900679904231",
"code": "101019644",
"accountNumberFormat": "ABA",
"paymentReference": null
}
]
},
{
"id": "a:25052256822125:xAWTzSB:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": null,
"name": "USDC Wallet",
"status": "ACTIVE",
"balance": {
"value": 1106.71,
"currencyCode": "USDC"
},
"ledgers": []
},
{
"id": "a:25052233445967:xnrik2v:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": null,
"name": "USDT Wallet",
"status": "ACTIVE",
"balance": {
"value": 120.50,
"currencyCode": "USDT"
},
"ledgers": []
},
{
"id": "a:25052137356562:qjOSsJf:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": "7e38e85f-8e1b-486d-b24f-28e4192f57f6",
"name": "USD Wallet NEW",
"status": "ACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "USD"
},
"ledgers": [
{
"type": "FIAT",
"accountHolderName": "Embedded Customer A",
"accountNumber": "900072464417",
"code": "101019644",
"accountNumberFormat": "ABA",
"paymentReference": null
}
]
},
{
"id": "a:25051268495394:hNyZppE:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": null,
"name": "Bitcoin Wallet Test account # 1",
"status": "INACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "BTC"
},
"ledgers": []
},
{
"id": "a:25042472328513:DjpwMfa:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": "7e38e85f-8e1b-486d-b24f-28e4192f57f6",
"name": "USD Wallet Test",
"status": "ACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "USD"
},
"ledgers": [
{
"type": "FIAT",
"accountHolderName": "Embedded Customer A",
"accountNumber": "900222018455",
"code": "101019644",
"accountNumberFormat": "ABA",
"paymentReference": null
}
]
},
{
"id": "a:25042460023997:xgImmdY:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": null,
"name": "ETH Wallet",
"status": "INACTIVE",
"balance": {
"value": 0.23,
"currencyCode": "ETH"
},
"ledgers": []
},
{
"id": "a:25041166078335:oYJeFUK:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": "7e38e85f-8e1b-486d-b24f-28e4192f57f6",
"name": "USDT Wallet",
"status": "ACTIVE",
"balance": {
"value": 71.63,
"currencyCode": "USDT"
},
"ledgers": []
},
{
"id": "a:25040249187073:wR42W6d:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": null,
"name": "USDC Wallet",
"status": "INACTIVE",
"balance": {
"value": 200.00,
"currencyCode": "USDC"
},
"ledgers": []
},
{
"id": "a:25040150970798:mGX7Twm:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": null,
"name": "Wallet EUR",
"status": "INACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "EUR"
},
"ledgers": []
},
{
"id": "a:25031066969227:zFSl3Ea:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": "7e38e85f-8e1b-486d-b24f-28e4192f57f6",
"name": "USD Wallet 3",
"status": "ACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "USD"
},
"ledgers": [
{
"type": "FIAT",
"accountHolderName": "Embedded Customer A",
"accountNumber": "900554317794",
"code": "101019644",
"accountNumberFormat": "ABA",
"paymentReference": null
}
]
},
{
"id": "a:25031066539770:Ia9mdf9:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": "9ba4c65c-8c81-4e39-80b6-a803d9e66efd",
"name": "USD Wallet Customer B",
"status": "INACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "USD"
},
"ledgers": []
},
{
"id": "a:25030652262360:ewsQxR8:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": "7e38e85f-8e1b-486d-b24f-28e4192f57f6",
"name": "USD Wallet 2",
"status": "ACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "USD"
},
"ledgers": [
{
"type": "FIAT",
"accountHolderName": "Embedded Customer A",
"accountNumber": "900914731533",
"code": "101019644",
"accountNumberFormat": "ABA",
"paymentReference": null
}
]
},
{
"id": "a:25030559783181:81aaB4K:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": null,
"name": "USD Swift",
"status": "ACTIVE",
"balance": {
"value": 137.00,
"currencyCode": "USD"
},
"ledgers": [
{
"type": "FIAT",
"accountHolderName": "System Pay Services Solutions Spain S.L.",
"accountNumber": "ES250182851098200007418",
"code": "BBVAESMMXXX",
"accountNumberFormat": "SWIFT",
"paymentReference": "REF-CL1CDC7"
}
]
},
{
"id": "a:25030558827793:LO8IHmy:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": "7e38e85f-8e1b-486d-b24f-28e4192f57f6",
"name": "USD Embedded Wallet",
"status": "ACTIVE",
"balance": {
"value": 872.00,
"currencyCode": "USD"
},
"ledgers": [
{
"type": "FIAT",
"accountHolderName": "Embedded Customer A",
"accountNumber": "900012647634",
"code": "101019644",
"accountNumberFormat": "ABA",
"paymentReference": null
}
]
},
{
"id": "a:25030548796673:JtdGolN:1",
"accountReference": "f539c983-c8cd-4db0-98bb-2de9e79d0e64",
"customerReference": null,
"name": "USD Main Wallet",
"status": "INACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "USD"
},
"ledgers": [
{
"type": "FIAT",
"accountHolderName": "Commercial US",
"accountNumber": "900364186010",
"code": "101019644",
"accountNumberFormat": "ABA",
"paymentReference": null
}
]
}
],
"pageable": {
"pageNumber": 0,
"pageSize": 20,
"sort": [],
"offset": 0,
"paged": true,
"unpaged": false
},
"last": false,
"totalElements": 23,
"totalPages": 2,
"first": true,
"size": 20,
"number": 0,
"sort": [],
"numberOfElements": 20,
"empty": false
}Retrieve wallet details by Customer reference
To retrieve wallet details by Customer reference, send the GET ledger/v1/wallets?customerReference={customerReference} request with the {customerReference} specified in the path.
curl --location 'https://api.sandbox.bvnk.com/ledger/v1/wallets?customerReference=a7e21c62-27b8-4b3b-b51e-eb10edeb1731' \
--header 'Authorization: Hawk id="vbfc61D890wg6LAAVbkR11qP9O6cXeMNmKWgcUNZaOHPiQeebp9cl6h02tWv84R8", ts="1728656563", nonce="voxeUs", mac="BO+hrUzE/tcWS89xTtvdfDacf+hQbtbHlAG9kwvyMuI="'In the response, you receive the list with detailed information on each Customer wallet:
{
"content": [
{
"id": "a:24101151618956:Xlfn0oR:1",
"accountReference": "ceb9400d-eee2-4cc0-89dc-1b3548f7291d",
"customerReference": "a7e21c62-27b8-4b3b-b51e-eb10edeb1731",
"name": "My USD Wallet",
"status": "INACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "USD"
},
"ledgers": []
},
{
"id": "a:24101151422432:gCl7SeI:1",
"accountReference": "ceb9400d-eee2-4cc0-89dc-1b3548f7291d",
"customerReference": "a7e21c62-27b8-4b3b-b51e-eb10edeb1731",
"name": "My USD Wallet 2",
"status": "INACTIVE",
"balance": {
"value": 0.00,
"currencyCode": "USD"
},
"ledgers": []
}
],
"pageable": {
"pageNumber": 0,
"pageSize": 20,
"sort": [],
"offset": 0,
"paged": true,
"unpaged": false
},
"last": true,
"totalElements": 2,
"totalPages": 1,
"first": true,
"size": 20,
"number": 0,
"sort": [],
"numberOfElements": 2,
"empty": false
}Retrieve wallet details by Wallet ID
To retrieve wallet details by its unique identifier, send the GET ledger/v1/wallets/{id} request with the {id} specified in the path.
curl --location 'https://api.sandbox.bvnk.com/ledger/v1/wallets/a:24101151422432:gCl7SeI:1' \
--header 'Authorization: Hawk id="vbfc61D890wg6LAAVbkR11qP9O6cXeMNmKWgcUNZaOHPiQeebp9cl6h02tWv84R8", ts="1728656463", nonce="3eTREz", mac="Ba7hBB5IpsG2P0Y6/cYSijO5w992yS6wZiNvjmiRpuU="'In the response, you receive the detailed information on the wallet:
{
"id": "a:24101151422432:gCl7SeI:1",
"accountReference": "ceb9400d-eee2-4cc0-89dc-1b3548f7291d",
"customerReference": "a7e21c62-27b8-4b3b-b51e-eb10edeb1731",
"name": "My USD Wallet 2",
"status": "INACTIVE",
"balance": {
"value": 1000.00,
"currencyCode": "USD"
},
"ledgers": []
}Updated 19 days ago