---
title: "Decodes the Filter"
method: POST
path: "/api/Filter/decode"
tags: ["Filter"]
---

# Decodes the Filter

`POST /api/Filter/decode`

## Request

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

Decoded filter will always have the same shape of Kavita.Models.DTOs.Filtering.v2.IFilterDto`2.
            The concrete class is driven by `EntityType`.
            Classes: Kavita.Models.DTOs.Filtering.v2.Requests.SeriesFilterV2Dto, Kavita.Models.DTOs.Filtering.v2.Requests.PersonFilterDto, Kavita.Models.DTOs.Filtering.v2.Requests.AnnotationFilterDto, Kavita.Models.DTOs.Filtering.v2.Requests.ReadingListFilterDto

## Request body

- DecodeFilterDto
  - `encodedFilter` string, nullable

## Response `200`

OK

- IFilterDto
  - `id` integer
  - `name` string, nullable
  - `combination` 0 | 1: Members: - `0` — Or - `1` — And
  - `limitTo` integer
  - `entityType` 0 | 1 | 2 | 3: Members: - `0` — Series - `1` — Reading List (ReadingList) - `2` — Person - `3` — Annotation

## Changes

- **2026-04-18** `58caf8bfeda1`: 6 warning, 3 info
  - removed the optional property `sortOptions` from the response with the `200` status (media type: text/plain)
  - removed the optional property `sortOptions` from the response with the `200` status (media type: application/json)
  - removed the optional property `sortOptions` from the response with the `200` status (media type: text/json)
  - removed the optional property `statements` from the response with the `200` status (media type: text/plain)
  - …5 more
- **2026-04-18** `62d7d023d949`: 3 warning
  - added the new `17.00` enum value to the `statements/items/comparison` response property for the response status `200` (media type: text/plain)
  - added the new `17.00` enum value to the `statements/items/comparison` response property for the response status `200` (media type: application/json)
  - added the new `17.00` enum value to the `statements/items/comparison` response property for the response status `200` (media type: text/json)
- **2026-04-16** `b20a3fdc8b42`: 3 warning
  - added the new `11.00` enum value to the `sortOptions/sortField` response property for the response status `200` (media type: text/plain)
  - added the new `11.00` enum value to the `sortOptions/sortField` response property for the response status `200` (media type: application/json)
  - added the new `11.00` enum value to the `sortOptions/sortField` response property for the response status `200` (media type: text/json)
- …earlier changes not shown

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