---
title: "Lists all book periods"
method: GET
path: "/books/periods"
tags: ["Books periods"]
---

# Lists all book periods

`GET /books/periods`

## Request

- Base URL: `https://api.rillet.com`
- URL: `https://api.rillet.com/books/periods`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/rillet/apis/rillet-accounting-api/docs/books/periods/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns every accounting period for the organization, newest first, regardless of whether each period is open or closed.
Use the returned ids to open or close the books or a specific subledger. The complete monthly history is returned without pagination.
Responds with HTTP 404 when the organization has no book periods.

## Response `200`

OK

- object
  - `periods` BookPeriod[], required
    - `id` string, uuid, required
    - `start` string, date, required: Book period start date (inclusive)
    - `end` string, date, required: Book period end date (inclusive)
    - `status` 'OPEN' | 'CLOSED', required
    - `closed_on` string, date, nullable, required: Date on which book was closed. Always null for open periods, and may also be null for closed periods without a recorded close date, so use `status` to tell whether the period is closed.

## Other responses

- `default`: Error

## Changes

- **2026-11-03** `c393d0102005`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rillet/apis/rillet-accounting-api/changes/books/periods/get.md)

---

[API](https://skmtc.dev/rillet/apis/rillet-accounting-api.md) - [All operations](https://skmtc.dev/rillet/apis/rillet-accounting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rillet/apis/rillet-accounting-api/revisions/c393d0102005?raw)