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

# Lists all books

`GET /books`

## Request

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

Returns all accounting books available to the authenticated organization.
Successful responses always contain at least one book and list the primary book first.
Only primary and adjustment-overlay book IDs can be used with report and journal-entry endpoints that accept a book_id.

## Response `200`

OK

- object
  - `books` LedgerBook[], required
    - `id` string, uuid, required
    - `name` string, required
    - `kind` 'PRIMARY' | 'SECONDARY', required
    - `mode` 'STANDALONE' | 'ADJUSTMENT_OVERLAY', required

## 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/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)