---
title: "GET /books"
method: GET
path: "/books"
---

# GET /books

`GET /books`

Returns a list of books

## Query parameters

- `authors` string[]
- `available` boolean
- `state` 'finished' | 'inprogress'
- `published` string, date
- `snake_case` string
- `completed` string, date-time
- `maxPages` number
- `min_pages` integer
- `pagesToTime` number, float
- `startingAfter` integer

## Headers

- `authorization` string

## Response `200`

Success

- Book[]
  - `id` integer
  - `name` string
  - `author` string, mongo-id
  - `genre` 'scifi' | 'mystery' | 'horror'
  - `other` unknown
  - `otherArray` unknown

## Other responses

- `default` — Error

## Changes

- **2017-02-16** `800bf7a9a3e4` — 1 info
  - added the new optional `header` request parameter `authorization`
- **2017-02-16** `2c022eb63067` — 1 warning
  - deleted the `header` request parameter `authorization`
- **2017-02-15** `8baf0d4a464c` — 1 info
  - added the new optional `header` request parameter `authorization`
- **2017-02-13** `f0b4ad044899` — 1 info
  - added the new optional `query` request parameter `startingAfter`
- **2016-10-20** `ae670caf5c72` — 2 warning
  - deleted the `header` request parameter `authorization`
  - deleted the `query` request parameter `startingAfter`

[Change history](https://skmtc.dev/clever/apis/swagger-test/changes/books/get.md)

---

[API](https://skmtc.dev/clever/apis/swagger-test.md) · [All operations](https://skmtc.dev/clever/apis/swagger-test/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clever/swagger-test/revisions/4208ba32ef8e/schema)