Balances and transactions

Volt provides an API to get basic details about every Volt Account you’ve opened, plus a full history of all credit and debit transactions for each account.

Please note that all data formats and structures detailed on this page are subject to change during the beta test period.

List of accounts

GET /api/accounts
{
    "accountId": "0db9c3f7-4dee-426e-bd84-86a862c30d88",
    "account": {
        "iban": "DK5250514614196798"
    },[
    {
        "accountId": "5aab1a5d-1647-45a3-956e-ce73ac813908",
        "account": {
            "iban": "DK2450517187342686"
        },
        "balance": "1973",
        "availableBalance": "1913",
        "currencyCode": "EUR",
        "timestamp": "2023-10-16T16:52:37+00:00"
    },
    {
        "accountId": "0db9c3f7-4dee-426e-bd84-86a862c30d88",
        "account": {
            "iban": "DK5250514614196798"
        },
        "balance": "3000",
        "availableBalance": "3000",
        "currencyCode": "EUR",
        "timestamp": "2023-10-16T16:45:02+00:00"
    }
]
    "balance": "0",
    "availableBalance": "0",
    "currencyCode": "EUR",
    "timestamp": "2023-10-16T16:21:48+00:00"
}

Balance and details of a specific account

Query path
Name Type Description
accountId String (uuid) id of the account you’d like details for
GET /api/accounts/{accountId}
[
    {
        "accountId": "5aab1a5d-1647-45a3-956e-ce73ac813908",
        "account": {
            "iban": "DK2450517187342686"
        },
        "balance": "1973",
        "availableBalance": "1913",
        "currencyCode": "EUR",
        "timestamp": "2023-10-16T16:52:37+00:00"
    },
    {
        "accountId": "0db9c3f7-4dee-426e-bd84-86a862c30d88",
        "account": {
            "iban": "DK5250514614196798"
        },
        "balance": "3000",
        "availableBalance": "3000",
        "currencyCode": "EUR",
        "timestamp": "2023-10-16T16:45:02+00:00"
    }
]

Transaction history

Query parameters (all optional)

Name Type Description
dateFrom YYYY-MM-DD Date in UTC
dateTo YYYY-MM-DD Date in UTC
payerTransactionId  string  transaction id set by payer 
type string debit or credit
debtorIban string  
creditorIban string  


Note
: This endpoint only shows successful debits and credits which have affected the account balance.

 

GET /api/accounts/{accountId}/transactions
{
    "accountId": "5aab1a5d-1647-45a3-956e-ce73ac813908",
    "dateFrom": "2023-09-01",
    "dateTo": "2023-10-26",
    "transactions": [
        {
            "id": "70e3783a-7129-43de-9f50-541bf2566a0b",
            "createdAt": "2023-10-16T17:20:35+00:00",
            "type": "internal",
            "reference": "2st transfer",
            "status": "completed",
            "amount": "100",
            "currency": "EUR",
            "debtorInformation": null,
            "creditorInformation": null
        },
        {
            "id": "5523755e-28b3-4e72-88c3-3dae870b16a8",
            "createdAt": "2023-10-16T17:18:19+00:00",
            "type": "internal",
            "reference": "1st transfer",
            "status": "completed",
            "amount": "100",
            "currency": "EUR",
            "debtorInformation": null,
            "creditorInformation": null
        },
        {
            "id": "f9126890-1180-4cd3-b477-9995ee09dd04",
            "createdAt": "2023-10-16T16:51:01+00:00",
            "type": "debit",
            "reference": "payment demo 2",
            "status": "completed",
            "amount": "13",
            "currency": "EUR",
            "debtorInformation": null,
            "creditorInformation": {
                "bic": "RABONL2UXXX",
                "iban": "NL11RABO4097012428",
                "accountName": "John Bloggs",
                "accountAddress": "1 Street, ABC123 Berlin, DE"
            }
        },
        {
            "id": "42704b00-593b-4bd2-b6b3-29f59c1ca1c6",
            "createdAt": "2023-10-16T16:50:54+00:00",
            "type": "debit",
            "reference": "payment demo 2",
            "status": "completed",
            "amount": "13",
            "currency": "EUR",
            "debtorInformation": null,
            "creditorInformation": {
                "bic": "RABONL2UXXX",
                "iban": "NL11RABO4097012428",
                "accountName": "John Bloggs",
                "accountAddress": "1 Street, ABC123 Berlin, DE"
            }
        },
        {
            "id": "a6d4551d-98ff-4d02-81b5-8431f59a10d7",
            "createdAt": "2023-10-16T16:50:30+00:00",
            "type": "debit",
            "reference": "payment demo 1",
            "status": "completed",
            "amount": "1",
            "currency": "EUR",
            "debtorInformation": null,
            "creditorInformation": {
                "bic": "RABONL2UXXX",
                "iban": "NL11RABO4097012428",
                "accountName": "John Bloggs",
                "accountAddress": "1 Street, ABC123 Berlin, DE"
            }
        },
        {
            "id": "2f7e290b-bb60-42bd-b5f4-2d150194df44",
            "createdAt": "2023-10-16T16:39:52+00:00",
            "type": "credit",
            "reference": "demo 14",
            "status": "completed",
            "amount": "1000",
            "currency": "EUR",
            "debtorInformation": {
                "iban": "NL08INGB4824538831",
                "country": "NL",
                "routing": "123123",
                "accountName": "Funding of test account",
                "accountAddress": "25 Debtor Testing Str."
            },
            "creditorInformation": null
        },
        {
            "id": "6d7a404a-7ee8-4850-a8f0-f7436cc41245",
            "createdAt": "2023-10-16T16:39:47+00:00",
            "type": "credit",
            "reference": "demo 12",
            "status": "completed",
            "amount": "1000",
            "currency": "EUR",
            "debtorInformation": {
                "iban": "NL08INGB4824538831",
                "country": "NL",
                "routing": "123123",
                "accountName": "Funding of test account",
                "accountAddress": "25 Debtor Testing Str."
            },
            "creditorInformation": null
        }
    ]
}