---
title: "Read bounded browser reference choices"
method: GET
path: "/api/v1/ui/references"
---

# Read bounded browser reference choices

`GET /api/v1/ui/references`

## Query parameters

- `q` string
- `project_uid` string
- `limit` integer

## Headers

- `If-None-Match` string

## Response `200`

OK

- UIReferencesResponseBody
  - `capabilities` UICapabilities, required
    - `actor_policy` string, required
    - `updates` 'sse' | 'poll', required
    - `writable` boolean, required
  - `contract_version` string, required
  - `cursor` integer, required
  - `issues` UIIssueReference[], nullable, required
    - `project_name` string, required
    - `project_uid` string, required
    - `qualified_id` string, required
    - `short_id` string, required
    - `status` string, required
    - `title` string, required
    - `uid` string, required
  - `labels` string[], nullable, required
  - `origin` string, required
  - `origin_stable` boolean, required
  - `owners` string[], nullable, required
  - `projects` Project[], nullable, required
    - `created_at` string, date-time, required
    - `deleted_at` string, date-time
    - `id` integer, required
    - `metadata` object, required
    - `name` string, required
    - `revision` integer, required
    - `uid` string, required

## Other responses

- `304` — References unchanged

---

[API](https://skmtc.net/kenn-io/apis/kata.md) · [All operations](https://skmtc.net/kenn-io/apis/kata/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kenn-io/kata/versions/14560b7a29ca/schema)