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 fee
  • inactive – is how many we have already pre-registered for you, your reserve/buffer
  • deactivated – is the amount of Virtual Accounts you deactivated