---
title: "Gets series with the applied Filter"
method: POST
path: "/api/Series/v2"
tags: ["Series"]
---

# Gets series with the applied Filter

`POST /api/Series/v2`

## Request

- Base URL: `http://localhost:5000`
- URL: `http://localhost:5000/api/Series/v2`
- Auth: API key in header `x-api-key`

## Query parameters

- `PageNumber` integer
- `PageSize` integer

## Request body

- SeriesFilterV2Dto
  - `id` integer
  - `name` string, nullable
  - `statements` SeriesFilterStatementDto[], nullable
    - `comparison` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17: Members: - `0` — Equal - `1` — GreaterThan - `2` — GreaterThanEqual - `3` — LessThan - `4` — LessThanEqual - `5` — Contains - `6` — MustContains - `7` — Matches - `8` — NotContains - `9` — NotEqual - `10` — BeginsWith - `11` — EndsWith - `12` — IsBefore - `13` — IsAfter - `14` — IsInLast - `15` — IsNotInLast - `16` — IsEmpty - `17` — IsNotEmpty
    - `field` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34: Members: - `0` — Summary - `1` — SeriesName - `2` — PublicationStatus - `3` — Languages - `4` — AgeRating - `5` — UserRating - `6` — Tags - `7` — CollectionTags - `8` — Translators - `9` — Characters - `10` — Publisher - `11` — Editor - `12` — CoverArtist - `13` — Letterer - `14` — Colorist - `15` — Inker - `16` — Penciller - `17` — Writers - `18` — Genres - `19` — Libraries - `20` — ReadProgress - `21` — Formats - `22` — ReleaseYear - `23` — ReadTime - `24` — Path - `25` — FilePath - `26` — WantToRead - `27` — ReadingDate - `28` — AverageRating - `29` — Imprint - `30` — Team - `31` — Location - `32` — ReadLast - `33` — FileSize - `34` — CollapseSeriesRelationships
    - `value` string, nullable
  - `combination` 0 | 1: Members: - `0` — Or - `1` — And
  - `sortOptions` SeriesSortOptionDto
    - `sortField` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11: Members: - `1` — SortName - `2` — CreatedDate - `3` — LastModifiedDate - `4` — LastChapterAdded - `5` — TimeToRead - `6` — ReleaseYear - `7` — ReadProgress - `8` — AverageRating - `9` — Random - `10` — UserRating - `11` — UnreadChapterCount
    - `isAscending` boolean
  - `entityType` 0 | 1 | 2 | 3: Members: - `0` — Series - `1` — Reading List (ReadingList) - `2` — Person - `3` — Annotation
  - `limitTo` integer

## Response `200`

OK

- SeriesDto[]
  - `id` integer
  - `name` string, nullable
  - `originalName` string, nullable
  - `localizedName` string, nullable
  - `sortName` string, nullable
  - `pages` integer
  - `coverImageLocked` boolean
  - `lastChapterAdded` string, date-time
  - `lastChapterAddedUtc` string, date-time
  - `userRating` number, float
  - `hasUserRated` boolean
  - `totalReads` integer
  - `pagesRead` integer
  - `latestReadDate` string, date-time
  - `format` 0 | 1 | 2 | 3 | 4: Members: - `0` — Image - `1` — Archive - `2` — Unknown - `3` — EPUB (Epub) - `4` — PDF (Pdf)
  - `created` string, date-time
  - `sortNameLocked` boolean
  - `localizedNameLocked` boolean
  - `nameLocked` boolean
  - `wordCount` integer
  - `libraryId` integer
  - `libraryName` string, nullable
  - `minHoursToRead` integer
  - `maxHoursToRead` integer
  - `avgHoursToRead` number, float
  - `folderPath` string, nullable
  - `lowestFolderPath` string, nullable
  - `lastFolderScanned` string, date-time
  - `dontMatch` boolean
  - `isBlacklisted` boolean
  - `isStandAlone` boolean
  - `metadataProviderOverride` 2 | 3 | 4: Members: - `2` — Hardcover - `3` — Mangabaka - `4` — ComicBookRoundup
  - `coverImage` string, nullable
  - `primaryColor` string, nullable
  - `secondaryColor` string, nullable
  - `aniListId` integer
  - `malId` integer
  - `hardcoverId` integer
  - `metronId` integer
  - `comicVineId` string, nullable
  - `mangaBakaId` integer
  - `mangaBakaEditionId` string, nullable
  - `cbrId` integer

## Changes

- **2026-08-19** `8f6bc4f38f06`: 3 info
  - added the optional property `items/metadataProviderOverride` to the response with the `200` status (media type: text/plain)
  - added the optional property `items/metadataProviderOverride` to the response with the `200` status (media type: application/json)
  - added the optional property `items/metadataProviderOverride` to the response with the `200` status (media type: text/json)
- **2026-08-08** `cc7f90a35897`: 3 info
  - added the new `34.00` enum value to the request property `statements/items/field` (media type: application/json)
  - added the new `34.00` enum value to the request property `statements/items/field` (media type: text/json)
  - added the new `34.00` enum value to the request property `statements/items/field` (media type: application/*+json)
- **2026-07-23** `751a92d6effc`: 9 info
  - added the optional property `items/isStandAlone` to the response with the `200` status (media type: text/plain)
  - added the optional property `items/isStandAlone` to the response with the `200` status (media type: application/json)
  - added the optional property `items/isStandAlone` to the response with the `200` status (media type: text/json)
  - added the optional property `items/mangaBakaEditionId` to the response with the `200` status (media type: text/plain)
  - …5 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/kareadita/apis/kavita/changes/api/Series/v2/post.md)

---

[API](https://skmtc.dev/kareadita/apis/kavita.md) - [All operations](https://skmtc.dev/kareadita/apis/kavita/llms.txt) - [OpenAPI document](https://skmtc.dev/kareadita/apis/kavita/revisions/d266465eeb67?raw)