---
title: "Get task labels"
method: GET
path: "/tasks/v1/taskboards/{taskBoardId}/labels"
tags: ["Tasks:v1:TaskLabels"]
---

# Get task labels

`GET /tasks/v1/taskboards/{taskBoardId}/labels`

Retrieve a list of task labels associated with the account

## Path parameters

- `taskBoardId` string, required — The unique identifier of the task board to filter by

## Query parameters

- `title` string — The title (name) of the label to filter by
- `limit` integer — The maximum number of results to display per page
- `offset` integer — The resource offset of the last successfully read resource will be returned as the paging.offset JSON property of a paginated response containing more results

## Response `200`

Successful Response

- PaginatedBaseResponseTaskLabelsResponse
  - `requestId` string
  - `data` TaskLabelsResponse, required
    - `labels` TaskLabel[], required — List of task labels
      - `id` string, required — The ID of the task label
      - `name` string, required — The name of the task label
      - `color` string, required — The color of the task label
  - `paging` PagingResponseModel, required
    - `offset` integer, required — The resource offset of the last successfully read resource will be returned as the paging.offset JSON property of a paginated response containing more results
    - `total` integer — Total number of resources matching the request, ignoring pagination. Use this to retrieve the full count without paginating through every page. Only populated by endpoints that compute it.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/connecteam/apis/connecteam-api-documentation.md) · [All operations](https://skmtc.net/connecteam/apis/connecteam-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/connecteam/connecteam-api-documentation/revisions/d8f7f302222e/schema)