---
title: "Sends a request to Kavita+ API for all potential matches, sorted by relevance"
method: POST
path: "/api/Series/match"
tags: ["Series"]
---

# Sends a request to Kavita+ API for all potential matches, sorted by relevance

`POST /api/Series/match`

## Request body

- MatchSeriesDto
  - `seriesId` integer
  - `query` string, nullable
  - `isStandAlone` boolean

## Response `200`

OK

- ExternalSeriesMatchDto[]
  - `series` ExternalSeriesDetailDto
    - `name` string, nullable
    - `titles` ALMediaTitle
      - `englishTitle` string, nullable
      - `romajiTitle` string, nullable
      - `nativeTitle` string, nullable
      - `preferredTitle` string, nullable
    - `localizedTitles` object, nullable
    - `aniListId` integer, nullable
    - `malId` integer, nullable
    - `cbrId` integer, nullable
    - `hardcoverId` integer, nullable
    - `isStandAlone` boolean
    - `mangabakaId` integer, nullable
    - `synonyms` string[], nullable
    - `plusMediaFormat` 1 | 2 | 3 | 4 | 5 — Members: - `1` — Manga - `2` — Comic - `3` — LightNovel - `4` — Book - `5` — Unknown
    - `siteUrl` string, nullable
    - `coverUrl` string, nullable
    - `genres` string[], nullable
    - `staff` SeriesStaffDto[], nullable
      - `name` string, nullable, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `url` string, nullable, required
      - `role` string, nullable, required
      - `imageUrl` string, nullable
      - `gender` string, nullable
      - `description` string, nullable
    - `tags` MetadataTagDto[], nullable
      - `name` string, nullable
      - `description` string, nullable
      - `rank` integer, nullable
      - `isGeneralSpoiler` boolean
      - `isMediaSpoiler` boolean
      - `isAdult` boolean
    - `summary` 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)
    - `provider` 0 | 1 | 2 | 4 | 5 | 6 — Members: - `0` — Kavita - `1` — AniList - `2` — Mal - `4` — Cbr - `5` — Hardcover - `6` — MangaBaka
    - `startDate` string, date-time, nullable
    - `endDate` string, date-time, nullable
    - `averageScore` integer
    - `chapters` integer
    - `volumes` integer
    - `relations` SeriesRelationship[], nullable
      - `aniListId` integer
      - `malId` integer, nullable
      - `mangabakaId` integer, nullable
      - `seriesName` ALMediaTitle
        - `englishTitle` string, nullable
        - `romajiTitle` string, nullable
        - `nativeTitle` string, nullable
        - `preferredTitle` string, nullable
      - `relation` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 16 — Members: - `1` — Prequel - `2` — Sequel - `3` — Spin Off (SpinOff) - `4` — Adaptation - `5` — Side Story (SideStory) - `6` — Character - `7` — Contains - `8` — Other - `9` — Alternative Setting (AlternativeSetting) - `10` — Alternative Version (AlternativeVersion) - `11` — Doujinshi - `12` — Parent - `13` — Edition - `14` — Annual - `16` — Cameo
      - `provider` 0 | 1 | 2 | 4 | 5 | 6 — Members: - `0` — Kavita - `1` — AniList - `2` — Mal - `4` — Cbr - `5` — Hardcover - `6` — MangaBaka
      - `format` 1 | 2 | 3 | 4 | 5 — Members: - `1` — Manga - `2` — Comic - `3` — LightNovel - `4` — Book - `5` — Unknown
      - `series` ExternalSeriesDetailDto — recursive
      - `metadataProvider` 2 | 3 | 4 — Members: - `2` — Hardcover - `3` — Mangabaka - `4` — ComicBookRoundup
    - `characters` SeriesCharacter[], nullable
      - `name` string, nullable
      - `description` string, nullable, required
      - `url` string, nullable, required
      - `imageUrl` string, nullable
      - `role` 0 | 1 | 2 — Members: - `0` — Main - `1` — Supporting - `2` — Background
    - `ratings` RatingDto[], nullable
      - `averageScore` integer
      - `favoriteCount` integer
      - `provider` 0 | 1 | 2 | 4 | 5 | 6 — Members: - `0` — Kavita - `1` — AniList - `2` — Mal - `4` — Cbr - `5` — Hardcover - `6` — MangaBaka
      - `authority` 0 | 1 — Members: - `0` — User - `1` — Critic
      - `providerUrl` string, nullable
    - `publisher` string, nullable
    - `chapterDtos` ExternalChapterDto[], nullable
      - `title` string, nullable
      - `issueNumber` string, nullable
      - `criticRating` number, double, nullable
      - `userRating` number, double, nullable
      - `summary` string, nullable
      - `writers` string[], nullable
      - `artists` string[], nullable
      - `releaseDate` string, date-time, nullable
      - `publisher` string, nullable
      - `coverImageUrl` string, nullable
      - `issueUrl` string, nullable
      - `hardcoverId` integer, nullable
      - `mangaBakaWorkId` string, nullable
      - `criticReviews` UserReviewDto[], nullable
        - `tagline` string, nullable
        - `body` string, nullable
        - `bodyJustText` string, nullable
        - `seriesId` integer
        - `chapterId` integer, nullable
        - `libraryId` integer
        - `username` string, nullable
        - `userId` integer
        - `totalVotes` integer
        - `rating` number, float
        - `rawBody` string, nullable
        - `score` integer
        - `siteUrl` string, nullable
        - `isExternal` boolean
        - `provider` 0 | 1 | 2 | 4 | 5 | 6 — Members: - `0` — Kavita - `1` — AniList - `2` — Mal - `4` — Cbr - `5` — Hardcover - `6` — MangaBaka
        - `authority` 0 | 1 — Members: - `0` — User - `1` — Critic
      - `userReviews` UserReviewDto[], nullable
        - `tagline` string, nullable
        - `body` string, nullable
        - `bodyJustText` string, nullable
        - `seriesId` integer
        - `chapterId` integer, nullable
        - `libraryId` integer
        - `username` string, nullable
        - `userId` integer
        - `totalVotes` integer
        - `rating` number, float
        - `rawBody` string, nullable
        - `score` integer
        - `siteUrl` string, nullable
        - `isExternal` boolean
        - `provider` 0 | 1 | 2 | 4 | 5 | 6 — Members: - `0` — Kavita - `1` — AniList - `2` — Mal - `4` — Cbr - `5` — Hardcover - `6` — MangaBaka
        - `authority` 0 | 1 — Members: - `0` — User - `1` — Critic
    - `editions` ExternalEditionDto[], nullable
      - `id` string, nullable, required
      - `title` string, nullable, required
      - `format` string, nullable, required
      - `language` string, nullable
      - `publisher` string, nullable
      - `type` 0 | 1 | 2 — Members: - `0` — Chapter - `1` — Volume - `2` — Other
      - `mainCount` integer
      - `totalCount` integer
  - `matchRating` number, float

---

[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/versions/a092f0284f3e/schema)