---
title: "List Labels"
method: GET
path: "/user/labels"
tags: ["Labels"]
---

# List Labels

`GET /user/labels`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/labels`
- Auth: HTTP bearer

List the labels in your account

[Docs](https://docs.famulor.io/api-v1/labels/list)

## Query parameters

- `per_page` integer
- `page` integer

## Response `200`

Success Response

- object
  - `data` object[]
    - `id` integer: The unique identifier of the label
    - `name` string: The label name
    - `color` string: The label color (or `null`)
    - `assistants_count` integer: Number of assistants this label is applied to

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `422`: Die Anfrage ist inhaltlich ungültig.

---

[API](https://skmtc.dev/famulor/apis/famulor-api.md) · [All operations](https://skmtc.dev/famulor/apis/famulor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/famulor/apis/famulor-api/revisions/3b938c370721?raw)