Get details of a Virtual Account
In order to get details of a specific Virtual Account set you can use the following endpoint. This might be useful if you didn’t store them during the initial fetch operation:
GET /api/accounts/identification-set/{identificationSetId}
The response will have a format very similar to the fetch operation response, with an added field for the status of the Virtual Account.
GET /api/accounts/identification-set/{identificationSetId}
{
"identificationSetId": "fbe8bd5d-13a4-4f73-aff4-1847005c3768",
"name": "fbe8bd5d-13a4-4f73-aff4-1847005c3768",
"defaultIdentificationId": "ee740b95-31ba-4237-b9e8-6f6c87fd0fb2",
"accountIdentifications": [
{
"id": "b79dee05-365c-434a-ba67-7b5e5211da99",
"identifications": {
"iban": "DE40202208000050999999"
}
},
{
"id": "c38647ef-8dca-4f3d-8853-7195ebb83994",
"identifications": {
"iban": "DK6089000050999999"
}
},
{
"id": "ee740b95-31ba-4237-b9e8-6f6c87fd0fb2",
"identifications": {
"iban": "GB64SAPY60838250999999"
}
},
{
"id": "ee750b95-31ba-42b7-b9e8-6f6c87fd0fb3",
"identifications": {
"iban": "LU70408000005999999"
}
}
],
"status": active
}
Monitor your Virtual Accounts
In order to find out how many Virtual Accounts you have with Volt, and how they’re being used, you can use the following stats endpoint:
GET /api/accounts/:accountsID/identification-sets/stats/
Which will return a response in the following format:
GET /api/accounts/:accountsID/identification-sets/stats/
{
"active": 2021,
"inactive": 10231,
"deactivated": 5
}
Key fields
active
– is the amount of active Virtual Accounts you have, charged with a monthly feeinactive
– is how many we have already pre-registered for you, your reserve/bufferdeactivated
– is the amount of Virtual Accounts you deactivated