---
title: "Return all Series that are in the current logged in user's Want to Read list, filtered"
method: POST
path: "/api/want-to-read/v2"
tags: ["WantToRead"]
---

# Return all Series that are in the current logged in user's Want to Read list, filtered

`POST /api/want-to-read/v2`

## Query parameters

- `PageNumber` integer
- `PageSize` integer
- `userId` 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

---

[API](https://skmtc.net/kareadita/apis/kavita.md) · [All operations](https://skmtc.net/kareadita/apis/kavita/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kareadita/kavita/revisions/06a131fe22cf/schema)