Skip to content

Accounts

Let's see how to create a bank account. πŸ’°πŸ’°πŸ’°

Not surprisingly, you need to be logged in to create an account or see your existing accounts. See Authorization for details.

Creating an account

Creating an account is easy. Use POST /accounts operation.

Pick a name for your account and set the initial balance in EUR. Oh, if making money was that easy! πŸ˜… In BankGround it is.

{
    "account_name": "Charles Goose - Business",
    "balance": 50000
}

Check the response. It should contain an IBAN, currency and other items:

{
    "id": 177,
    "account_name": "Charles Goose - Business",
    "balance": 50000,
    "currency": "EUR",
    "iban": "GB85SASL44193852448864",
    "created_at": "2023-05-23T14:58:06.390610+00:00",
    "last_activity": "2023-05-23T14:58:06.390628+00:00"
}
πŸ‘ You have created your first account. You can make another account if you want.

Listing accounts

You can list all your accounts with a GET /accounts request.

The response will be a JSON array of your accounts:

[
    {
        "id": 177,
        "account_name": "Charles Goose - Business",
        "balance": 50000.0,
        "currency": "EUR",
        "iban": "GB85SASL44193852448864",
        "created_at": "2023-05-23T14:58:06.390610+00:00",
        "last_activity": "2023-05-23T14:58:06.390628+00:00"
    },
    {
        "id": 178,
        "account_name": "Charles Goose - Personal",
        "balance": 37000.0,
        "currency": "EUR",
        "iban": "GB07LIAP90710553025752",
        "created_at": "2023-05-23T15:00:45.506633+00:00",
        "last_activity": "2023-05-23T15:00:45.506650+00:00"
    }
]

Account details

You can see the details of a single account with a GET /accounts/{id} request.

Now, let's make some transactions. πŸ’ΈπŸ’ΈπŸ’Έ