---
title: "Retrieves a book period by date"
method: GET
path: "/books/periods/{date}"
tags: ["Books periods"]
---

# Retrieves a book period by date

`GET /books/periods/{date}`

## Request

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

Returns the accounting period containing the requested date, regardless of whether the period is open or closed.
Use the returned id to open or close the books or a specific subledger. Responds with HTTP 404 when no period contains the date.

## Path parameters

- `date` string, date, required

## Response `200`

OK

- BookPeriod
  - `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/:date/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)