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

# List labels

`GET /v2/labels`

## Request

- Base URL: `https://thirdparty.qonto.com`
- URL: `https://thirdparty.qonto.com/v2/labels`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://oauth.qonto.com/oauth2/auth`
    - Token URL: `https://oauth.qonto.com/oauth2/token` scopes: `organization.read`
  - API key in header `Authorization`

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

## Changes

- **2025-01-24** (v2) `25208d6f9deb`: 3 breaking
  - the `labels/items/parent_id` response's property type changed from no type to `string` for status `200`
  - the `meta/next_page` response's property type changed from no type to `integer` for status `200`
  - the `meta/prev_page` response's property type changed from no type to `integer` for status `200`

[Operation history](https://skmtc.dev/hiit-consulting-fr/apis/qonto/changes/v2/labels/get.md)

---

[API](https://skmtc.dev/hiit-consulting-fr/apis/qonto.md) - [All operations](https://skmtc.dev/hiit-consulting-fr/apis/qonto/llms.txt) - [OpenAPI document](https://skmtc.dev/hiit-consulting-fr/apis/qonto/revisions/25208d6f9deb?raw)