---
title: "Returns metadata for a given series"
method: GET
path: "/api/Series/metadata"
tags: ["Series"]
---

# Returns metadata for a given series

`GET /api/Series/metadata`

## Request

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

## Query parameters

- `seriesId` integer

## Response `200`

OK

- SeriesMetadataDto
  - `id` integer
  - `summary` string, nullable
  - `genres` GenreTagDto[], nullable
    - `id` integer
    - `title` string, nullable, required
  - `tags` TagDto[], nullable
    - `id` integer
    - `title` string, nullable, required
  - `writers` PersonDto[], nullable
    - `id` integer
    - `name` string, nullable, required
    - `coverImageLocked` boolean
    - `primaryColor` string, nullable
    - `secondaryColor` string, nullable
    - `coverImage` string, nullable
    - `aliases` string[], nullable
    - `description` string, nullable
    - `asin` string, nullable
    - `aniListId` integer
    - `malId` integer
    - `hardcoverId` string, nullable
    - `webLinks` string[], nullable
    - `roles` PersonRole[], nullable
  - `coverArtists` PersonDto[], nullable
    - `id` integer
    - `name` string, nullable, required
    - `coverImageLocked` boolean
    - `primaryColor` string, nullable
    - `secondaryColor` string, nullable
    - `coverImage` string, nullable
    - `aliases` string[], nullable
    - `description` string, nullable
    - `asin` string, nullable
    - `aniListId` integer
    - `malId` integer
    - `hardcoverId` string, nullable
    - `webLinks` string[], nullable
    - `roles` PersonRole[], nullable
  - `publishers` PersonDto[], nullable
    - `id` integer
    - `name` string, nullable, required
    - `coverImageLocked` boolean
    - `primaryColor` string, nullable
    - `secondaryColor` string, nullable
    - `coverImage` string, nullable
    - `aliases` string[], nullable
    - `description` string, nullable
    - `asin` string, nullable
    - `aniListId` integer
    - `malId` integer
    - `hardcoverId` string, nullable
    - `webLinks` string[], nullable
    - `roles` PersonRole[], nullable
  - `characters` PersonDto[], nullable
    - `id` integer
    - `name` string, nullable, required
    - `coverImageLocked` boolean
    - `primaryColor` string, nullable
    - `secondaryColor` string, nullable
    - `coverImage` string, nullable
    - `aliases` string[], nullable
    - `description` string, nullable
    - `asin` string, nullable
    - `aniListId` integer
    - `malId` integer
    - `hardcoverId` string, nullable
    - `webLinks` string[], nullable
    - `roles` PersonRole[], nullable
  - `pencillers` PersonDto[], nullable
    - `id` integer
    - `name` string, nullable, required
    - `coverImageLocked` boolean
    - `primaryColor` string, nullable
    - `secondaryColor` string, nullable
    - `coverImage` string, nullable
    - `aliases` string[], nullable
    - `description` string, nullable
    - `asin` string, nullable
    - `aniListId` integer
    - `malId` integer
    - `hardcoverId` string, nullable
    - `webLinks` string[], nullable
    - `roles` PersonRole[], nullable
  - `inkers` PersonDto[], nullable
    - `id` integer
    - `name` string, nullable, required
    - `coverImageLocked` boolean
    - `primaryColor` string, nullable
    - `secondaryColor` string, nullable
    - `coverImage` string, nullable
    - `aliases` string[], nullable
    - `description` string, nullable
    - `asin` string, nullable
    - `aniListId` integer
    - `malId` integer
    - `hardcoverId` string, nullable
    - `webLinks` string[], nullable
    - `roles` PersonRole[], nullable
  - `imprints` PersonDto[], nullable
    - `id` integer
    - `name` string, nullable, required
    - `coverImageLocked` boolean
    - `primaryColor` string, nullable
    - `secondaryColor` string, nullable
    - `coverImage` string, nullable
    - `aliases` string[], nullable
    - `description` string, nullable
    - `asin` string, nullable
    - `aniListId` integer
    - `malId` integer
    - `hardcoverId` string, nullable
    - `webLinks` string[], nullable
    - `roles` PersonRole[], nullable
  - `colorists` PersonDto[], nullable
    - `id` integer
    - `name` string, nullable, required
    - `coverImageLocked` boolean
    - `primaryColor` string, nullable
    - `secondaryColor` string, nullable
    - `coverImage` string, nullable
    - `aliases` string[], nullable
    - `description` string, nullable
    - `asin` string, nullable
    - `aniListId` integer
    - `malId` integer
    - `hardcoverId` string, nullable
    - `webLinks` string[], nullable
    - `roles` PersonRole[], nullable
  - `letterers` PersonDto[], nullable
    - `id` integer
    - `name` string, nullable, required
    - `coverImageLocked` boolean
    - `primaryColor` string, nullable
    - `secondaryColor` string, nullable
    - `coverImage` string, nullable
    - `aliases` string[], nullable
    - `description` string, nullable
    - `asin` string, nullable
    - `aniListId` integer
    - `malId` integer
    - `hardcoverId` string, nullable
    - `webLinks` string[], nullable
    - `roles` PersonRole[], nullable
  - `editors` PersonDto[], nullable
    - `id` integer
    - `name` string, nullable, required
    - `coverImageLocked` boolean
    - `primaryColor` string, nullable
    - `secondaryColor` string, nullable
    - `coverImage` string, nullable
    - `aliases` string[], nullable
    - `description` string, nullable
    - `asin` string, nullable
    - `aniListId` integer
    - `malId` integer
    - `hardcoverId` string, nullable
    - `webLinks` string[], nullable
    - `roles` PersonRole[], nullable
  - `translators` PersonDto[], nullable
    - `id` integer
    - `name` string, nullable, required
    - `coverImageLocked` boolean
    - `primaryColor` string, nullable
    - `secondaryColor` string, nullable
    - `coverImage` string, nullable
    - `aliases` string[], nullable
    - `description` string, nullable
    - `asin` string, nullable
    - `aniListId` integer
    - `malId` integer
    - `hardcoverId` string, nullable
    - `webLinks` string[], nullable
    - `roles` PersonRole[], nullable
  - `teams` PersonDto[], nullable
    - `id` integer
    - `name` string, nullable, required
    - `coverImageLocked` boolean
    - `primaryColor` string, nullable
    - `secondaryColor` string, nullable
    - `coverImage` string, nullable
    - `aliases` string[], nullable
    - `description` string, nullable
    - `asin` string, nullable
    - `aniListId` integer
    - `malId` integer
    - `hardcoverId` string, nullable
    - `webLinks` string[], nullable
    - `roles` PersonRole[], nullable
  - `locations` PersonDto[], nullable
    - `id` integer
    - `name` string, nullable, required
    - `coverImageLocked` boolean
    - `primaryColor` string, nullable
    - `secondaryColor` string, nullable
    - `coverImage` string, nullable
    - `aliases` string[], nullable
    - `description` string, nullable
    - `asin` string, nullable
    - `aniListId` integer
    - `malId` integer
    - `hardcoverId` string, nullable
    - `webLinks` string[], nullable
    - `roles` PersonRole[], 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)
  - `releaseYear` integer
  - `language` string, nullable
  - `maxCount` integer
  - `totalCount` integer
  - `publicationStatus` 0 | 1 | 2 | 3 | 4: Members: - `0` — Ongoing (OnGoing) - `1` — Hiatus - `2` — Completed - `3` — Cancelled - `4` — Ended
  - `webLinks` string, nullable
  - `languageLocked` boolean
  - `summaryLocked` boolean
  - `ageRatingLocked` boolean
  - `publicationStatusLocked` boolean
  - `genresLocked` boolean
  - `tagsLocked` boolean
  - `writerLocked` boolean
  - `characterLocked` boolean
  - `coloristLocked` boolean
  - `editorLocked` boolean
  - `inkerLocked` boolean
  - `imprintLocked` boolean
  - `lettererLocked` boolean
  - `pencillerLocked` boolean
  - `publisherLocked` boolean
  - `translatorLocked` boolean
  - `teamLocked` boolean
  - `locationLocked` boolean
  - `coverArtistLocked` boolean
  - `releaseYearLocked` boolean
  - `seriesId` integer

## Changes

- **2026-04-13** `2a82e5fe5308`: 39 info
  - removed the `1.00` enum value from the `characters/items/roles/items/` response property for the response status `200` (media type: text/plain)
  - removed the `1.00` enum value from the `characters/items/roles/items/` response property for the response status `200` (media type: application/json)
  - removed the `1.00` enum value from the `characters/items/roles/items/` response property for the response status `200` (media type: text/json)
  - removed the `1.00` enum value from the `colorists/items/roles/items/` response property for the response status `200` (media type: text/plain)
  - …35 more
- **2025-10-25** `07751d5dca44`: 78 info
  - added the optional property `characters/items/roles` to the response with the `200` status (media type: text/plain)
  - added the optional property `characters/items/roles` to the response with the `200` status (media type: application/json)
  - added the optional property `characters/items/roles` to the response with the `200` status (media type: text/json)
  - added the optional property `characters/items/webLinks` to the response with the `200` status (media type: text/plain)
  - …74 more
- …earlier changes not shown

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