---
title: "GET /api/v1/projects/{project_id}/search"
method: GET
path: "/api/v1/projects/{project_id}/search"
---

# GET /api/v1/projects/{project_id}/search

`GET /api/v1/projects/{project_id}/search`

## Path parameters

- `project_id` integer, required

## Query parameters

- `q` string, required
- `limit` integer
- `include_deleted` boolean
- `mode` 'auto' | 'lexical' | 'hybrid' | 'semantic'
- `label` string[], nullable
- `exclude_label` string[], nullable

## Response `200`

OK

- SearchResponseBody
  - `degraded` boolean
  - `degraded_reason` string
  - `mode` string, required
  - `query` string, required
  - `results` SearchHit[], nullable, required
    - `issue` Issue, required
      - `author` string, required
      - `body` string, required
      - `closed_at` string, date-time
      - `closed_reason` string
      - `created_at` string, date-time, required
      - `deleted_at` string, date-time
      - `id` integer, required
      - `metadata` object, required
      - `occurrence_key` string
      - `owner` string
      - `priority` integer
      - `project_id` integer, required
      - `project_uid` string
      - `recurrence_id` integer
      - `revision` integer, required
      - `short_id` string, required
      - `status` string, required
      - `title` string, required
      - `uid` string, required
      - `updated_at` string, date-time, required
    - `matched_in` string[], nullable, required
    - `score` number, double, required

## Other responses

- `default` — Error

## Changes

- **2026-08-07** `d8237a47d2fc` — 2 info
  - added the new optional `query` request parameter `exclude_label`
  - added the new optional `query` request parameter `label`
- **2026-06-29** `4e9583bdae5d` — 4 info
  - added the new optional `query` request parameter `mode`
  - added the optional property `degraded` to the response with the `200` status
  - added the optional property `degraded_reason` to the response with the `200` status
  - added the required property `mode` to the response with the `200` status
- **2026-06-05** `783ece1efda1` — 1 breaking, 3 warning
  - removed the required property `mode` from the response with the `200` status
  - deleted the `query` request parameter `mode`
  - removed the optional property `degraded` from the response with the `200` status
  - removed the optional property `degraded_reason` from the response with the `200` status

[Change history](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/projects/:project_id/search/get.md)

---

[API](https://skmtc.dev/kenn-io/apis/kata.md) · [All operations](https://skmtc.dev/kenn-io/apis/kata/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kenn-io/kata/revisions/2d4207e1e028/schema)