Kavita Series API

The Series API from Kavita — 31 operation(s) for series.

GitHub OpenAPI

Operations 33

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /api/Series/v2 Search series with filters · Gets series with the applied Filter #
Ask an LLM
“How do I find series that match certain statements?”
“Can I combine filters with AND or OR?”
Tell an agent
Find series matching {statements}.
Search series with {statements} combined as {combination}.
GET /api/Series/{seriesId} Get a series by ID · Fetches a Series for a given Id #
Ask an LLM
“How do I fetch one series by its ID?”
“What details come back for a single series?”
Tell an agent
Get series {seriesId}.
Show the details of series {seriesId}.
DELETE /api/Series/{seriesId} Delete a series · Deletes a series from Kavita #
Ask an LLM
“How do I remove a series from Kavita?”
“Can I delete one series by ID?”
Tell an agent destructive · confirm first
Delete series {seriesId}.
Remove the series with ID {seriesId}.
POST /api/Series/delete-multiple Delete several series at once · Deletes multiple series from Kavita at once #
Ask an LLM
“How do I delete multiple series from Kavita in one request?”
“Can I clear out several series IDs I listed at once?”
Tell an agent destructive · confirm first
Delete these series: {seriesIds}.
Remove the series {seriesIds} from Kavita.
GET /api/Series/volumes List a series's volumes with progress · Returns All volumes for a series with progress information and Chapters #
Ask an LLM
“How do I see every volume of a series with reading progress?”
“Which chapters are in each volume of a series?”
Tell an agent
List volumes for series {seriesId}.
Show all volumes of series {seriesId} with progress.
GET /api/Series/volume Get one volume of a series · Returns a single Volume with progress information and Chapters #
Ask an LLM
“How do I fetch a single volume by its ID?”
“What progress and chapters does one volume have?”
Tell an agent
Get volume {volumeId}.
Show volume {volumeId} of its series.
GET /api/Series/chapter Get one chapter of a series · Returns a single Chapter with progress information #
Ask an LLM
“How do I fetch a single chapter by its ID?”
“What progress does one chapter have?”
Tell an agent
Get chapter {chapterId}.
Show chapter {chapterId} of its series.
POST /api/Series/update Update a series · Updates the Series #
Ask an LLM
“How do I rename a series or change its sort name?”
“Can I lock a series's name or metadata provider?”
Tell an agent
Rename series {id} to {name}.
Set series {id} sort name to {sortName}.
POST /api/Series/recently-added-v2 List recently added series · Gets all recently added series #
Ask an LLM
“Which series were added to the library most recently?”
“Can I filter recently added series?”
Tell an agent
List recently added series matching {statements}.
Show the latest {PageSize} series added to library.
POST /api/Series/recently-updated-series List series recently updated · Returns series that were recently updated, like adding or removing a chapter #
Ask an LLM
“Which series had chapters added or removed recently?”
“What was the most recently updated series?”
Tell an agent
List series recently updated.
Show the {PageSize} series that changed most recently.
POST /api/Series/all-v2 List all series in a library · Returns all series for the library #
Ask an LLM
“Which series are in my Kavita library?”
“Can I filter the series list by name or sort it?”
Tell an agent
List all series for user {userId}.
Show every series in the library, {pageSize} per page.
POST /api/Series/on-deck List series on deck · Fetches series that are on deck aka have progress on them #
Ask an LLM
“Which series have progress and are on deck?”
“Can I see on-deck series for one library?”
Tell an agent
List series on deck for library {libraryId}.
Show the series users are currently reading.
POST /api/Series/remove-from-on-deck Remove a series from on deck · Removes a series from displaying on deck until the next read event on that… #
Ask an LLM
“How do I stop a series from showing on deck?”
“Can I clear a series from on deck until the next read?”
Tell an agent
Remove series {seriesId} from on deck.
Clear series {seriesId} from the on-deck list.
GET /api/Series/currently-reading List series a user is reading · Get series a user is currently reading, requires the user to share their profile #
Ask an LLM
“Which series is a user currently reading?”
“Can I see currently reading series for another user?”
Tell an agent
List series user {userId} is currently reading.
Show the books in progress for {userId}.
POST /api/Series/refresh-metadata Refresh a series's cover and metadata · Runs a Cover Image Generation task #
Ask an LLM
“How do I force Kavita to regenerate a series's cover image?”
“Can I refresh metadata for one series?”
Tell an agent
Refresh metadata for series {seriesId}.
Regenerate the cover for series {seriesId}.
POST /api/Series/scan Rescan a series's files · Scan a series and force each file to be updated. #
Ask an LLM
“How do I force Kavita to rescan every file in a series?”
“Can I rescan a series and update its chapters?”
Tell an agent
Rescan series {seriesId} in library {libraryId}.
Force update all files in series {seriesId}.
POST /api/Series/analyze Analyze a series's files · Run a file analysis on the series #
Ask an LLM
“How do I run a file analysis on a series?”
“Can I analyze a series without rescanning it?”
Tell an agent
Run a file analysis on series {seriesId}.
Analyze the files of series {seriesId} in library {libraryId}.
GET /api/Series/metadata Get a series's metadata · Returns metadata for a given series #
Ask an LLM
“How do I read the metadata of a series?”
“What metadata fields does a series have?”
Tell an agent
Get metadata for series {seriesId}.
Show the metadata of series {seriesId}.
POST /api/Series/metadata Update a series's metadata · Update series metadata #
Ask an LLM
“How do I change a series's metadata?”
“Can I update several metadata fields at once?”
Tell an agent
Update series metadata with {seriesMetadata}.
Save the metadata changes {seriesMetadata} to the series.
GET /api/Series/series-by-collection List series in a collection · Returns all Series grouped by the passed Collection Id with Pagination #
Ask an LLM
“How do I get all series in a collection?”
“Can I page through a collection's series?”
Tell an agent
List series in collection {collectionId}.
Show the {PageSize} series in collection {collectionId}.
POST /api/Series/series-by-ids Fetch series by series IDs · Fetches Series for a set of Ids. #
Ask an LLM
“How do I fetch a set of series by their IDs?”
“Can I look up several series in one call?”
Tell an agent
Fetch the series with IDs {seriesIds}.
Get series {seriesIds} from the library.
GET /api/Series/age-rating Look up an age rating enum value · Get the age rating for the Kavita.Models.Entities.Enums.AgeRating enum value #
Ask an LLM
“What does a given age rating enum value mean?”
“Can I translate an age rating ID into its text?”
Tell an agent
Get the age rating for {ageRating}.
Look up what age rating {ageRating} represents.
GET /api/Series/series-detail Get a series detail DTO · Get a special DTO for Series Detail page #
Ask an LLM
“What does the special series detail page show for one series?”
“Is there a detailed series DTO I can fetch?”
Tell an agent
Get the series detail for {seriesId}.
Fetch the detailed series DTO for series {seriesId}.
GET /api/Series/related Get a series' related series · Fetches the related series for a given series #
Ask an LLM
“Which series are related to a given series?”
“Can I get only one relation type, like sequels, for a series?”
Tell an agent
Get the {relation} related to series {seriesId}.
Show the {relation} series for {seriesId}.
GET /api/Series/all-related Get all related series for a series · Returns all related series against the passed series Id #
Ask an LLM
“Can I get every related series for a series in one call?”
“What are all the prequels, sequels and spin-offs of a series?”
Tell an agent
Get all related series for {seriesId}.
Show every relation type for series {seriesId}.
POST /api/Series/update-related Update a series' related series · Update the relations attached to the Series. #
Ask an LLM
“How do I set the sequels or prequels on a series?”
“Can I change which series are related to a series?”
Tell an agent
Set the sequels of series {seriesId} to {sequels}.
Update the related series on {seriesId} with {prequels} and {spinOffs}.
GET /api/Series/external-series-detail Get external metadata for a series · Returns external series metadata around a Given External Series #
Ask an LLM
“Where can I get external metadata for a series, like from AniList or MyAnimeList?”
“Can I look up a series by its AniList or MAL ID?”
Tell an agent
Get external series metadata for series {seriesId}.
Look up the AniList ID {aniListId} for external series details.
GET /api/Series/next-expected Estimate when a series' next chapter is expected · Based on the delta times between when chapters are added, for series that are… #
Ask an LLM
“When is the next chapter of a series likely to be added?”
“Can Kavita predict the next chapter release for a series?”
Tell an agent
Estimate when the next chapter of {seriesId} is expected.
Predict the next chapter release for series {seriesId}.
POST /api/Series/match Search for a series match on Kavita+ · Sends a request to Kavita+ API for all potential matches, sorted by relevance #
Ask an LLM
“How do I find a Kavita+ match for a series by name?”
“Can I search Kavita+ for a series I already have?”
Tell an agent
Search Kavita+ for a match to {query}.
Find the best Kavita+ match for series {seriesId}.
POST /api/Series/update-match Confirm or fix a Kavita+ match · This will perform the fix match #
Ask an LLM
“How do I accept a Kavita+ match and set the MAL ID?”
“Can I mark a series match as wrong?”
Tell an agent
Confirm the Kavita+ match for {seriesId} from provider {provider}.
Set the MAL ID {malId} on the confirmed match for {seriesId}.
POST /api/Series/dont-match Stop Kavita from trying to match a series · When true, will not perform a match and will prevent Kavita from attempting to… #
Ask an LLM
“How do I tell Kavita not to try matching a series anymore?”
“Can I prevent a series from being matched again?”
Tell an agent
Don't match series {seriesId}.
Set dontMatch to {dontMatch} for {seriesId}.
GET /api/Series/match-info Get match info for a series · Returns extra information around an existing match (and series) to display on… #
Ask an LLM
“What match information is stored for a series?”
“Can I see the match details for a series?”
Tell an agent
Get the match info for series {seriesId}.
Show the existing match details for {seriesId}.
GET /api/Series/series-with-annotations List series a user can access · Returns all Series that a user has access to #
Ask an LLM
“Which series does the current user have access to?”
“Can I get all series with annotations?”
Tell an agent
List all series the user can access.
Show every series with annotations.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/kavita:kavita-series-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

kavita-series-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Kavita Series API
  description: Kavita provides a set of APIs authenticated via an Auth Key passed in the `x-api-key` header. Generate an Auth Key under User Settings → Manage Auth Keys, paste it into the Authorize panel, and all Try It requests will include it. Assume all fields of a payload are required unless marked optional. Built against v0.9.1.15
  license:
    name: GPL-3.0
    url: https://github.com/Kareadita/Kavita/blob/develop/LICENSE
  version: 0.9.1.15
servers:
- url: '{protocol}://{hostpath}'
  variables:
    protocol:
      default: http
      enum:
      - http
      - https
    hostpath:
      default: localhost:5000
security:
- AuthKey: []
tags:


# --- truncated at 32 KB (84 KB total) ---
# Full source: https://artifacts.apis.io/kavita/openapi/kavita-series-api-openapi.yml