---
title: "Fetches people from the instance"
method: GET
path: "/api/Metadata/people"
tags: ["Metadata"]
---

# Fetches people from the instance

`GET /api/Metadata/people`

## Request

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

## Query parameters

- `libraryIds` string

## Response `200`

OK

- PersonDto[]
  - `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

## Changes

- **2026-04-13** `2a82e5fe5308`: 3 info
  - removed the `1.00` enum value from the `items/roles/items/` response property for the response status `200` (media type: text/plain)
  - removed the `1.00` enum value from the `items/roles/items/` response property for the response status `200` (media type: application/json)
  - removed the `1.00` enum value from the `items/roles/items/` response property for the response status `200` (media type: text/json)
- **2025-10-25** `07751d5dca44`: 6 info
  - added the optional property `items/roles` to the response with the `200` status (media type: text/plain)
  - added the optional property `items/roles` to the response with the `200` status (media type: application/json)
  - added the optional property `items/roles` to the response with the `200` status (media type: text/json)
  - added the optional property `items/webLinks` to the response with the `200` status (media type: text/plain)
  - …2 more
- **2025-05-09** `908c551d05bb`: 3 info
  - added the optional property `items/aliases` to the response with the `200` status (media type: text/plain)
  - added the optional property `items/aliases` to the response with the `200` status (media type: application/json)
  - added the optional property `items/aliases` to the response with the `200` status (media type: text/json)

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