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

# Fetches people from the instance by role

`GET /api/Metadata/people-by-role`

## Query parameters

- `role` 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 — Members: - `3` — Writer - `4` — Penciller - `5` — Inker - `6` — Colorist - `7` — Letterer - `8` — CoverArtist - `9` — Editor - `10` — Publisher - `11` — Character - `12` — Translator - `13` — Imprint - `14` — Team - `15` — Location

## 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

---

[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/revisions/cc7f90a35897/schema)