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

# List labels

`GET /v2/labels`

OAuth scope: `organization.read`

---

Retrieve all labels within the organization.

---

The response contains the list of labels that are linked to the authenticated company.

The `id` field uniquely identifies the label and is used to identify the **label_ids** of a transaction (see [List transactions](/reference/openapi_v2.yml/paths/~1v2~1transactions/get))

### Parent

A label can be linked to another in order to create lists.
The parent label can be identified thanks to the `parent_id` field.

## Headers

- `X-Qonto-Staging-Token` string

## Response `200`

list labels for a given organization

- object
  - `labels` object[]
    - `id` string
    - `name` string
    - `parent_id` string, nullable
  - `meta` object
    - `current_page` integer
    - `next_page` integer, nullable
    - `prev_page` integer, nullable
    - `total_pages` integer
    - `total_count` integer
    - `per_page` integer

---

[API](https://skmtc.net/hiit-consulting-fr/apis/qonto.md) · [All operations](https://skmtc.net/hiit-consulting-fr/apis/qonto/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiit-consulting-fr/qonto/versions/25208d6f9deb/schema)