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
        }
    ]
}