# 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&#x26;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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://monse.gitbook.io/monse/reference/bank-accounts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.