---
title: "Returns a list of annotations for browsing"
method: POST
path: "/api/Annotation/all-filtered"
tags: ["Annotation"]
---

# Returns a list of annotations for browsing

`POST /api/Annotation/all-filtered`

## Request

- Base URL: `http://localhost:5000`
- URL: `http://localhost:5000/api/Annotation/all-filtered`
- Auth: API key in header `x-api-key`

## Query parameters

- `PageNumber` integer
- `PageSize` integer

## Request body

- AnnotationFilterDto
  - `id` integer
  - `name` string, nullable
  - `statements` AnnotationFilterStatementDto[], 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` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9: Members: - `1` — Owner - `2` — Library - `3` — Spoiler - `4` — HighlightSlot - `5` — Selection - `6` — Comment - `7` — Series - `8` — Likes - `9` — LikedBy
    - `value` string, nullable
  - `combination` 0 | 1: Members: - `0` — Or - `1` — And
  - `sortOptions` AnnotationSortOptionDto
    - `sortField` 1 | 2 | 3 | 4: Members: - `1` — Owner - `2` — Created - `3` — LastModified - `4` — Color
    - `isAscending` boolean
  - `entityType` 0 | 1 | 2 | 3: Members: - `0` — Series - `1` — Reading List (ReadingList) - `2` — Person - `3` — Annotation
  - `limitTo` integer

## Response `200`

OK

- AnnotationDto[]
  - `id` integer
  - `xPath` string, nullable, required
  - `endingXPath` string, nullable
  - `selectedText` string, nullable
  - `comment` string, nullable
  - `commentHtml` string, nullable
  - `commentPlainText` string, nullable
  - `chapterTitle` string, nullable
  - `context` string, nullable
  - `highlightCount` integer
  - `containsSpoiler` boolean
  - `pageNumber` integer
  - `selectedSlotIndex` integer
  - `likes` integer[], nullable
  - `seriesName` string, nullable
  - `libraryName` string, nullable
  - `chapterId` integer, required
  - `volumeId` integer, required
  - `seriesId` integer, required
  - `libraryId` integer, required
  - `ownerUserId` integer, required
  - `ownerUsername` string, nullable
  - `ageRating` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | -1: Members: - `0` — Unknown - `1` — Rating Pending (RatingPending) - `2` — Early Childhood (EarlyChildhood) - `3` — Everyone - `4` — G - `5` — Everyone 10+ (Everyone10Plus) - `6` — PG - `7` — Kids to Adults (KidsToAdults) - `8` — Teen - `9` — MA15+ (Mature15Plus) - `10` — Mature 17+ (Mature17Plus) - `11` — M (Mature) - `12` — R18+ (R18Plus) - `13` — Adults Only 18+ (AdultsOnly) - `14` — X18+ (X18Plus) - `-1` — Not Applicable (NotApplicable)
  - `createdUtc` string, date-time
  - `lastModifiedUtc` string, date-time

## Changes

- **2026-04-18** `58caf8bfeda1`: 3 info
  - added the new optional request property `entityType` (media type: application/json)
  - added the new optional request property `entityType` (media type: text/json)
  - added the new optional request property `entityType` (media type: application/*+json)
- **2026-04-18** `62d7d023d949`: 3 info
  - added the new `17.00` enum value to the request property `statements/items/comparison` (media type: application/json)
  - added the new `17.00` enum value to the request property `statements/items/comparison` (media type: text/json)
  - added the new `17.00` enum value to the request property `statements/items/comparison` (media type: application/*+json)
- **2025-12-13** `ba8553c39654`: 6 info
  - added the new `8.00` enum value to the request property `statements/items/field` (media type: application/json)
  - added the new `8.00` enum value to the request property `statements/items/field` (media type: text/json)
  - added the new `8.00` enum value to the request property `statements/items/field` (media type: application/*+json)
  - added the new `9.00` enum value to the request property `statements/items/field` (media type: application/json)
  - …2 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/kareadita/apis/kavita/changes/api/Annotation/all-filtered/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)