# Kavita Reading List API

**Canonical:** https://apis.io/apis/kavita/kavita-reading-list-api/  
**Provider:** Kavita — https://apis.io/providers/kavita/  
**Documentation:** https://wiki.kavitareader.com/

Kavita Reading List API is one of 48 APIs that [Kavita](https://apis.io/providers/kavita/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Reading List. The published artifact set on APIs.io includes an OpenAPI specification.

The Reading List API from Kavita — 26 operation(s) for reading list.

## Operations (27)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/ReadingList` | Fetches a single Reading List |
| DELETE | `/api/ReadingList` | Deletes a reading list |
| POST | `/api/ReadingList/lists` | Returns reading lists (paginated) for a given user |
| POST | `/api/ReadingList/all` | Returns reading lists (paginated) for a given user |
| GET | `/api/ReadingList/lists-for-series` | Returns all Reading Lists the user has access to that the given series within it |
| GET | `/api/ReadingList/lists-for-chapter` | Returns all Reading Lists the user has access to that has the given chapter… |
| GET | `/api/ReadingList/items` | Fetches all reading list items for a given list including rich metadata around… |
| POST | `/api/ReadingList/update-position` | Updates an items position |
| POST | `/api/ReadingList/delete-item` | Deletes a list item from the list. Item orders will update as a result |
| POST | `/api/ReadingList/remove-read` | Removes all entries that are fully read from the reading list |
| POST | `/api/ReadingList/create` | Creates a new List with a unique title. Returns the new ReadingList back |
| POST | `/api/ReadingList/update` | Update the properties (title, summary) of a reading list |
| POST | `/api/ReadingList/update-by-series` | Adds all chapters from a Series to a reading list |
| POST | `/api/ReadingList/update-by-multiple` | Adds all chapters from a list of volumes and chapters to a reading list |
| POST | `/api/ReadingList/update-by-multiple-series` | Adds all chapters from a list of series to a reading list |
| POST | `/api/ReadingList/update-by-volume` | Create api reading list update by volume |
| POST | `/api/ReadingList/update-by-chapter` | Create api reading list update by chapter |
| GET | `/api/ReadingList/people` | Returns a list of a given role associated with the reading list |
| GET | `/api/ReadingList/all-people` | Returns all people in given roles for a reading list |
| GET | `/api/ReadingList/next-chapter` | Returns the next chapter within the reading list |
| GET | `/api/ReadingList/prev-chapter` | Returns the prev chapter within the reading list |
| GET | `/api/ReadingList/name-exists` | Checks if a reading list exists with the name |
| POST | `/api/ReadingList/promote-multiple` | Promote/UnPromote multiple reading lists in one go. |
| POST | `/api/ReadingList/delete-multiple` | Delete multiple reading lists in one go |
| GET | `/api/ReadingList/info` | Returns random information about a Reading List |
| POST | `/api/ReadingList/export-as-cbl` | Export a Reading List to CBL format |
| POST | `/api/ReadingList/regenerate-cover` | Regenerates the cover image for a reading list, you must own the given reading… |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/kavita/openapi/kavita-reading-list-api-openapi.yml

## Other Kavita APIs (12)

- [Kavita API](https://apis.io/apis/kavita/kavita-api/)
- [Kavita Account API](https://apis.io/apis/kavita/kavita-account-api/)
- [Kavita Activity API](https://apis.io/apis/kavita/kavita-activity-api/)
- [Kavita Admin API](https://apis.io/apis/kavita/kavita-admin-api/)
- [Kavita Annotation API](https://apis.io/apis/kavita/kavita-annotation-api/)
- [Kavita Book API](https://apis.io/apis/kavita/kavita-book-api/)
- [Kavita Cbl API](https://apis.io/apis/kavita/kavita-cbl-api/)
- [Kavita Chapter API](https://apis.io/apis/kavita/kavita-chapter-api/)
- [Kavita Collection API](https://apis.io/apis/kavita/kavita-collection-api/)
- [Kavita Color Scape API](https://apis.io/apis/kavita/kavita-colorscape-api/)
- [Kavita Device API](https://apis.io/apis/kavita/kavita-device-api/)
- [Kavita Download API](https://apis.io/apis/kavita/kavita-download-api/)

## Tags

Reading List

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/kavita/kavita-reading-list-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/kavita/.