---
title: "Changes to ListBooks"
method: GET
path: "/v1/shelves/{shelf}/books"
---

# Changes to ListBooks

`GET /v1/shelves/{shelf}/books`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 9 of 12 revisions.

- **2022-04-11** (v1) `ac9d37cae0e0` — 2 breaking
- **2022-02-23** (v1) `639a4ec995ca` — 1 info
- **2022-01-12** (v1) `dbd82bd71d47` — 1 breaking
- **2022-01-12** (v1) `00e696b6b84a` — 1 breaking, 1 info
- **2022-01-12** (v1) `fab7e7c2f60c` — 1 breaking
- **2022-01-11** (v1) `26b3bc7b5169` — 1 breaking
- **2022-01-11** (v1) `2a0f5e3b8734` — 1 info
- **2022-01-11** (v1) `0dea6034d969` — 1 info
- **2021-12-09** (v1) `1f7e8ced5369` — 4 breaking, 2 info

## Changes

- **2022-04-11** (v1) `ac9d37cae0e0` — 2 breaking
  - the response's body type changed from no type to `object` for status `200`
  - the `books/items/` response's property type changed from no type to `object` for status `200`
- **2022-02-23** (v1) `639a4ec995ca` — 1 info
  - the response property `books/items/name` became required for the status `200`
- **2022-01-12** (v1) `dbd82bd71d47` — 1 breaking
  - the `books/items/borrow_time` response's property format changed from `RFC3339` to `date-time` for status `200`
- **2022-01-12** (v1) `00e696b6b84a` — 1 breaking, 1 info
  - the `books/items/borrow_time` response's property format changed from `date-time` to `RFC3339` for status `200`
  - the `books/items/name` response's property pattern `^shelves/[a-z2-7]{26}/books/[a-z2-7]{26}$` was added for the status `200`
- **2022-01-12** (v1) `fab7e7c2f60c` — 1 breaking
  - the `books/items/borrow_time` response's property format changed from `RFC3339` to `date-time` for status `200`
- **2022-01-11** (v1) `26b3bc7b5169` — 1 breaking
  - for the `query` request parameter `page_size`, the type changed from `string` to `integer`, and format from no format to `int32`
- **2022-01-11** (v1) `2a0f5e3b8734` — 1 info
  - api operation id `ListBooks` removed and replaced with `LibraryService_ListBooks`
- **2022-01-11** (v1) `0dea6034d969` — 1 info
  - api operation id `LibraryService_ListBooks` removed and replaced with `ListBooks`
- **2021-12-09** (v1) `1f7e8ced5369` — 4 breaking, 2 info
  - the response's body type changed from `object` to no type for status `200`
  - the response property `books/items/name` became optional for the status `200`
  - the `books/items/` response's property type changed from `object` to no type for status `200`
  - the `books/items/borrow_time` response's property format changed from `date-time` to `RFC3339` for status `200`
  - for the `query` request parameter `page_size`, the type was generalized from `integer` to `string`, and format from `int32` to no format
  - the `books/items/name` response's property pattern `^shelves/[a-z2-7]{26}/books/[a-z2-7]{26}$` was removed for the status `200`

---

[Operation](https://skmtc.dev/kollalabs/apis/libraryservice-api/docs/v1/shelves/:shelf/books/get.md) · [API](https://skmtc.dev/kollalabs/apis/libraryservice-api.md) · [Page](https://skmtc.dev/kollalabs/apis/libraryservice-api/changes/v1/shelves/:shelf/books/get)