> For the complete documentation index, see [llms.txt](https://monse.gitbook.io/monse/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://monse.gitbook.io/monse/reference/bank-accounts.md).

# Bank Accounts

List, create, update or delete your bank accounts

<figure><img src="https://3951518618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWGgseqlXEOM9RYwFKGxp%2Fuploads%2FdH424poeMWJXKgPl8t4r%2Fimage.png?alt=media&amp;token=c454d05e-7466-4b5a-84c1-0c2aa2c45221" alt=""><figcaption></figcaption></figure>

### Endpoints

## Get a list of all your bank accounts

<mark style="color:blue;">`GET`</mark> `https://monse.app/v1/bank-accounts`

#### Query Parameters

| Name    | Type   | Description                                                              |
| ------- | ------ | ------------------------------------------------------------------------ |
| include | string | If you want to receive lso de bank information you can add it as 'bank'. |

{% tabs %}
{% tab title="200: OK List of Bank Accounts" %}

```javascript
[
    {
	"id": 1,
	"external_uuid": "4a2e413e-949e-3804-aa6s-0f2ca6a08bcb",
	"bank_id": 3,
	"bank_connection_id": 1,
	"iban": "SE3212339877030000000000",
	"name": "CUENTA NOMINA",
	"currency": "EUR",
	"balance": 4399311,
	"hidden": false,
	"deleted_at": null,
	"created_at": "2022-09-04T16:10:06.000000Z",
	"updated_at": "2022-09-04T16:10:06.000000Z"
    },
    
    // ...
]
```

{% endtab %}
{% endtabs %}

## Create a new manual bank account

<mark style="color:green;">`POST`</mark> `https://monse.app/v1/bank-accounts`

You can create a new manual account to track your balance and transactions. The different between this and the connected accounts is that this account need to be updated manually, creating or updating the balance every some time.

#### Request Body

| Name                                       | Type    | Description                   |
| ------------------------------------------ | ------- | ----------------------------- |
| name<mark style="color:red;">\*</mark>     | String  | Bank account name             |
| currency<mark style="color:red;">\*</mark> | String  | Currency Code: EUR, USD, etc. |
| balance<mark style="color:red;">\*</mark>  | Integer | Current balance in cents.     |

{% tabs %}
{% tab title="201: Created " %}

```javascript
{
    'id': 1
}
```

{% endtab %}
{% endtabs %}

## Update an account

<mark style="color:orange;">`PUT`</mark> `https://monse.app/v1/bank-accounts/{id}`

#### Query Parameters

| Name | Type    | Description     |
| ---- | ------- | --------------- |
| id   | Integer | Bank account ID |

#### Request Body

| Name | Type   | Description               |
| ---- | ------ | ------------------------- |
| name | String | New name for bank account |

{% tabs %}
{% tab title="204: No Content Bank account edited" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

## Delete an account

<mark style="color:red;">`DELETE`</mark> `https://monse.app/v1/bank-accounts/{id}`

You can only delete manual accounts.

#### Query Parameters

| Name | Type    | Description     |
| ---- | ------- | --------------- |
| id   | Integer | Bank account ID |

{% tabs %}
{% tab title="204: No Content Account deleted" %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="401: Unauthorized You can't delete this account" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}