# period_status

`POST /api/v1/queries/period_status`

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



## Request body

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

Example:

```json
{
  "ledger_id": "11111111-1111-4111-8111-111111111111"
}
```

## Response (200)

| Field | Type | Required | Description |
|---|---|---|---|
| `periods` | array of object | yes |  |
| `periods[].end_date` | string (date) | yes |  |
| `periods[].id` | string (uuid) | yes |  |
| `periods[].start_date` | string (date) | yes |  |
| `periods[].status` | string | yes |  |


## 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).