---
title: "List labels"
method: GET
path: "/brandfolders/{brandfolder_id}/labels"
tags: ["labels"]
---

# List labels

`GET /brandfolders/{brandfolder_id}/labels`

Lists the labels in the matching Brandfolder.

## Response `200`

The labels in the matching Brandfolder.

- object
  - `data` Label[], required
    - `id` string, required — Unique identifier for the resource instance.
    - `type` 'labels', required — The type of the resource.
    - `attributes` LabelAttributes, required
      - `name` string — The name of the label.
      - `path` unknown[] — Hierarchy of label IDs, starting with this label's ID.
        - unknown
      - `position` integer — Label location represented by a positive integer; `0` is the first position.
      - `depth` integer — The depth of the label hierarchy. A root level label's depth is `1`, a label with one parent has depth of `2`, and so on.
  - `meta` PaginationMetadataResponse, required — Page context information.
    - `current_page` integer, required
    - `next_page` object, nullable, required
    - `prev_page` object, nullable, required
    - `total_pages` unknown, required
    - `total_count` unknown, required

## Other responses

- `default` — Generic error payload

---

[API](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/brandfolder-openapi-reference/versions/fd95b0a2d2f8/schema)