pinakes/docs/api/books.md

Books

Book metadata, series, authors, and reading progress

Endpoints

GET /api/v1/books

List all books with optional search filters

Authentication: Required (Bearer JWT)

Parameters

Name	In	Required	Description
isbn	query	No	Filter by ISBN
author	query	No	Filter by author
series	query	No	Filter by series
publisher	query	No	Filter by publisher
language	query	No	Filter by language
offset	query	No	Pagination offset
limit	query	No	Pagination limit

Responses

Status	Description
200	List of books
401	Unauthorized
500	Internal server error

---

GET /api/v1/books/authors

List all authors with book counts

Authentication: Required (Bearer JWT)

Parameters

Name	In	Required	Description
offset	query	No	Pagination offset
limit	query	No	Pagination limit

Responses

Status	Description
200	Authors with book counts
401	Unauthorized

---

GET /api/v1/books/authors/{name}/books

Get books by a specific author

Authentication: Required (Bearer JWT)

Parameters

Name	In	Required	Description
name	path	Yes	Author name
offset	query	No	Pagination offset
limit	query	No	Pagination limit

Responses

Status	Description
200	Books by author
401	Unauthorized

---

GET /api/v1/books/reading-list

Get user's reading list

Authentication: Required (Bearer JWT)

Parameters

Name	In	Required	Description
status	query	No	Filter by reading status

Responses

Status	Description
200	Reading list
401	Unauthorized

---

GET /api/v1/books/series

List all series with book counts

Authentication: Required (Bearer JWT)

Responses

Status	Description
200	List of series with counts
401	Unauthorized

---

GET /api/v1/books/series/{name}

Get books in a specific series

Authentication: Required (Bearer JWT)

Parameters

Name	In	Required	Description
name	path	Yes	Series name

Responses

Status	Description
200	Books in series
401	Unauthorized

---

GET /api/v1/books/{id}/metadata

Get book metadata by media ID

Authentication: Required (Bearer JWT)

Parameters

Name	In	Required	Description
id	path	Yes	Media item ID

Responses

Status	Description
200	Book metadata
401	Unauthorized
404	Not found

---

GET /api/v1/books/{id}/progress

Get reading progress for a book

Authentication: Required (Bearer JWT)

Parameters

Name	In	Required	Description
id	path	Yes	Media item ID

Responses

Status	Description
200	Reading progress
401	Unauthorized
404	Not found

---

PUT /api/v1/books/{id}/progress

Update reading progress for a book

Authentication: Required (Bearer JWT)

Parameters

Name	In	Required	Description
id	path	Yes	Media item ID

Request Body

Content-Type: application/json

See docs/api/openapi.json for the full schema.

Responses

Status	Description
204	Progress updated
400	Bad request
401	Unauthorized

---