---
title: "Search Labels"
method: GET
path: "/api/v1/labels/search"
tags: ["Labels"]
---

# Search Labels

`GET /api/v1/labels/search`

Search user labels by name.

This is a paginated endpoint. See the [Pagination guide](#tag/Pagination) for details on using cursor-based pagination.

## Query parameters

- `query` string, required — Search query to match label names. Matching is case-insensitive. Queries are matched literally unless `*` (wildcard) is included. Use `\*` for literal asterisk and `\\` for literal backslash.
- `cursor` string, nullable — An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
- `limit` integer — The number of objects to return in a page

## Response `200`

Successful Response

- PaginatedListLabelRestView
  - `results` LabelRestView[], required — Objects in the current page of results.
    - `id` string, required — String ID of the label.
    - `name` string, required — Label name.
    - `color` string, required — Label color name.
    - `order` integer, nullable, required — Position of the label in the label list, or `null` when no explicit order is set.
    - `is_favorite` boolean, required — Whether the label is marked as a favorite.
  - `next_cursor` string, nullable, required — Cursor for the next page of results, or `null` when there are no more results.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

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