Periods & close
Closing a period finalizes the books for a date range so the numbers can't drift after the fact.
What closing does
When you close an accounting period, the engine:
- Posts the closing entry that rolls the period's net income into equity (retained earnings).
- Locks the date range — new entries can no longer be posted with dates inside a closed period.
This gives you a stable, audited cutoff for reporting and compliance.
Closing and reopening
| Operation | Endpoint |
|---|---|
| Close a period | POST /periods/close |
| Reopen a period | POST /periods/reopen |
| List closed periods | GET /periods |
Reopening reverses the close — it unlocks the range and backs out the closing
entry — so you can make corrections and close again. Both operations are
available in the API reference and as MCP tools
(close_period, reopen_period, list_closed_periods).
Order of operations
Close periods in chronological order, and make sure all entries for the period are posted (not left as drafts) before closing — drafts don't roll into the closing entry.
Events
Closing and reopening emit webhook events
(period.closed, period.reopened) so downstream systems can react.
Next
- Reports — how the balance sheet ties out via current-year earnings.