> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperline.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Close accounting periods

> Close months on a Hyperline ledger so their entries never change, reopen them with a reason, and see how closed fiscal years show in your financial reports.

Once you have reported on a month, close it on the ledger to make sure its numbers stay the same. Nobody can add, change, or remove an entry dated in a closed month. Billing activity that arrives late still reaches your books: it posts in the first open month.

You close months per [ledger](https://docs.hyperline.co/docs/accounting/ledgers.md). For example, you can close your statutory ledger while an audit adjustment ledger stays open.

> [!NOTE]
>
> Closing and reopening months requires the **Close and reopen accounting months** permission. See [Permissions](https://docs.hyperline.co/docs/accounting/getting-started.md#permissions).

## Close months

1. Go to **Accounting** > **Settings**.
2. In the **Configuration** section, open the actions menu (**⋯**) and click **Close months**.
3. Select the **Month** and the **Year** to close through. Both default to last month.
4. Click **Close months**.

![Close months modal with the month and year to close through](https://mintcdn.com/hyperline/a8XGV75NMwaPOgln/images/accounting/period-close-close-months.png?fit=max\&auto=format\&n=a8XGV75NMwaPOgln\&q=85\&s=dacf0796cfa12653c5d4fc73c7a682df)

Every month up to and including the selected month closes. The **Configuration** section then shows **Closed through** with the last closed month.

![Configuration section showing the fiscal year end and the last closed month](https://mintcdn.com/hyperline/a8XGV75NMwaPOgln/images/accounting/period-close-settings.png?fit=max\&auto=format\&n=a8XGV75NMwaPOgln\&q=85\&s=d70975bd3b7ebfb21050060554711748)

* You can close several months at once. On a ledger with history, your first close can be any past month.
* You can only close a month that has ended, so the latest month you can close is last month.
* Before closing, Hyperline posts the [revenue recognition](https://docs.hyperline.co/docs/accounting/revenue-recognition.md) due up to the end of the selected month, so it lands in its own month.

> [!NOTE]
>
> Months follow the timezone of the ledger's invoicing entity, like the [financial reports](https://docs.hyperline.co/docs/accounting/accounts.md#export-financial-reports). If you change that timezone, entries posted near midnight can move to another day or month, closed months included.

## Reopen months

Reopen months when a closed month needs a correction, for example a manual entry dated in that month.

1. Go to **Accounting** > **Settings**.
2. In the **Configuration** section, open the actions menu (**⋯**) and click **Reopen months**.
3. Select the **Month** and the **Year** to reopen from. Both default to the last closed month.
4. Select a **Reason**: **Error in posted entries**, **Month closed by mistake**, **Late or missing transaction**, **Audit adjustment**, or **Other** to describe it yourself.
5. Click **Reopen months**.

![Reopen months modal with the month to reopen from and a reason](https://mintcdn.com/hyperline/a8XGV75NMwaPOgln/images/accounting/period-close-reopen-months.png?fit=max\&auto=format\&n=a8XGV75NMwaPOgln\&q=85\&s=174db0558392cfe146ace76e8098356d)

The selected month and every later month reopen. The reason is required and recorded in the [close history](#close-history-and-api).

> **Example 💡**
>
> Your ledger is closed through September. You reopen from July to fix an entry: July, August, and September reopen, and the ledger is now closed through June. Once you have posted the fix, close through September again.

## What a closed month means

| Activity dated in a closed month | What happens |
| - | - |
| Automatic entries: invoices, credit notes, payments, refunds, write-offs, payouts, revenue recognition | Posted on the first day of the first open month |
| [Manual entries](https://docs.hyperline.co/docs/accounting/manual-entries.md), from the app or the API | Refused |
| Replays of past periods by our team | Skip the documents with entries in a closed month |

### Late entries

An automatic entry dated in a closed month still posts, so nothing is missing from your books. It posts on the first day of the first open month, and its description ends with a note giving its original date. An invoice issued with a past date in a closed month follows the same rule.

> **Example 💡**
>
> September is closed. On October 2, you record a bank transfer received on September 29. Its entry posts on October 1, and its description gives September 29 as the original date.

### Manual entries

In the app, the entry date picker doesn't offer days in a closed month. Through the API, Hyperline refuses a manual entry dated in a closed month, and the error gives the first date you can use. To post an entry in a closed month, reopen the month first.

## Yearly close

There is no separate action to close a fiscal year. Closing the months through the ledger's fiscal year end freezes the year.

Hyperline posts no closing entry. Instead, the balance sheet and the general ledger exports compute the result of past fiscal years as a **Prior years result** line, apart from the **Current year result**. See [Prior years result](https://docs.hyperline.co/docs/accounting/accounts.md#prior-years-result).

The fiscal year end is set when you [create the ledger](https://docs.hyperline.co/docs/accounting/ledgers.md#create-a-ledger), December by default, and can't be changed afterwards. The reports apply it to the ledger's whole history, so a change would move amounts between the prior years result and the current year result in months already reported.

A late entry for a closed fiscal year posts in the new year, like any late entry. To book it in the closed year, reopen its months and post a manual correction.

> **Example 💡**
>
> Your fiscal year ends in December. In January 2027, you close through December 2026. On any balance sheet dated in 2027, the 2026 result is part of the prior years result, and no entry can change it while December stays closed.

## Close history and API

The app shows the last closed month. Hyperline also records every close and reopen: who did it, when, which months it covered, and the reason. You can read this history through the API.

| Action | Endpoint |
| - | - |
| Get the last closed month and the latest month you can close | [`GET /v1/accounting/ledgers/{id}/close`](https://docs.hyperline.co/api-reference/endpoints/accounting->-ledgers/get-ledger-close-state) |
| List the close history, newest first | [`GET /v1/accounting/ledgers/{id}/close-events`](https://docs.hyperline.co/api-reference/endpoints/accounting->-ledgers/list-ledger-close-events) |
| Close months, with an optional reason | [`POST /v1/accounting/ledgers/{id}/close`](https://docs.hyperline.co/api-reference/endpoints/accounting->-ledgers/close-ledger-period) |
| Reopen months, with a required reason | [`POST /v1/accounting/ledgers/{id}/reopen`](https://docs.hyperline.co/api-reference/endpoints/accounting->-ledgers/reopen-ledger-period) |

Ledgers also return `closed_through_date`, the last day of the last closed month.

Closing and reopening through the API requires an API key with write access. A user token also needs the **Close and reopen accounting months** permission. The close is never automatic, but you can automate it on your side through the API, for example a few days after each month end.

> [!NOTE]
>
> Is something still unclear? Don't hesitate to reach out to our team via the
> in-app chat if you need additional support.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.