# close_period

`POST /api/v1/commands/close_period`

Base URL: `https://boringbooks.io`.



## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `ledger_id` | string (uuid) | yes |  |
| `period_id` | string (uuid) | yes |  |
| `retained_earnings_account_id` | string (uuid) | yes |  |

Example:

```json
{
  "ledger_id": "11111111-1111-4111-8111-111111111111",
  "period_id": "55555555-5555-4555-8555-555555555555",
  "retained_earnings_account_id": "88888888-8888-4888-8888-888888888888"
}
```

## Response (200)

| Field | Type | Required | Description |
|---|---|---|---|
| `status` | string | yes |  |
| `journal_id` | string (uuid), nullable | no |  |


## Errors

Every error response is a single `error` object with a closed `type` and a refining
`code`. The codes, and the conventions every operation shares, are in
[llms-full.txt](https://boringbooks.io/llms-full.txt).