# chart_of_accounts

`POST /api/v1/queries/chart_of_accounts`

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 |
|---|---|---|---|
| `accounts` | array of object | yes |  |
| `accounts[].active` | boolean | no |  |
| `accounts[].code` | string | no |  |
| `accounts[].contra` | boolean | no |  |
| `accounts[].id` | string (uuid) | no |  |
| `accounts[].name` | string | no |  |
| `accounts[].postable` | boolean | no |  |
| `accounts[].type` | string | no |  |
| `currency` | `Currency` | yes |  |

## Shared types

Fields typed with one of these names refer to it.

- `Currency` (string): An ISO 4217 alphabetic currency code — a ledger's own functional currency. The supported set is additive, so do not treat it as closed.

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