---
title: "Letter ledger entry lines"
method: POST
path: "/api/external/v2/ledger_entry_lines/lettering"
tags: ["Ledger Entry Lines"]
---

# Letter ledger entry lines

`POST /api/external/v2/ledger_entry_lines/lettering`

This endpoint lets you letter ledger entry lines together. All
received entry lines will be lettered together. If a passed entry line is
already lettered, then the lettering will be applied to its associated lettered
entry lines as well.

> ℹ️
> This endpoint requires the following scope: `ledger_entries:all`

## Request body

- object
  - `unbalanced_lettering_strategy` 'none' | 'partial', required — - `none`: the API won't let you create an unbalanced lettering and will respond with an error. - `partial`: a potentially unbalanced lettering will be created.
  - `ledger_entry_lines` object[], required — The list of ledger entry lines you want to letter together. You can provide ledger entry lines already lettered and they don't have to be part of the same lettering. All received entry lines will be lettered together. If a passed entry line is already lettered, then the lettering will be applied to its lettered entry lines as well. For example: Ledger entry lines `A` and `B` are already lettered together. `C` in not lettered. When requesting `[A, C]` to be lettered, the final lettering will be `[A, B, C]`.
    - `id` integer, required — Id of the ledger entry line

## Response `200`

Returns all the ledger entry lines of the new lettering

- object[] — An array containing all the ledger entry lines of the new lettering
  - `id` integer, required — Id of the ledger entry line

## Other responses

- `400` — Bad request
- `401` — Access token is missing or invalid
- `403` — Access to this resource forbidden
- `404` — The resource was not found
- `422` — Unprocessable content

---

[API](https://skmtc.net/pennylane/apis/company-v2.md) · [All operations](https://skmtc.net/pennylane/apis/company-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pennylane/company-v2/versions/a5b7236473c6/schema)