---
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
- `issue_uid` string[]
- `limit` integer

## Headers

- `If-None-Match` string

## Response `200`

OK

- UIReferencesResponseBody
  - `capabilities` UICapabilities, required
    - `actor_policy` string, required
    - `allowed_actions` string[]
    - `close_requires_evidence` boolean
    - `expires_at` string, date-time
    - `scope` TokenScopeOut
      - `kind` 'issue_subtree', required
      - `project_uid` string, required
      - `root_issue_uid` string, required
    - `token_audit_read` boolean
    - `updates` 'sse' | 'poll', required
    - `writable` boolean, required
  - `contract_version` string, required
  - `cursor` integer, required
  - `issues` UIIssueReference[], 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[], required
  - `origin` string, required
  - `origin_stable` boolean, required
  - `owners` string[], required
  - `projects` ProjectOut[], required
    - `active` boolean, required
    - `created_at` string, date-time, required
    - `deleted_at` string, date-time
    - `id` integer, required
    - `metadata` object, required
    - `name` string, required
    - `revision` integer, required
    - `stats` ProjectStatsOut
      - `closed` integer, required
      - `last_event_at` string, date-time, nullable, required
      - `open` integer, required
    - `uid` string, required

## Other responses

- `304` — References unchanged

## Changes

- **2026-09-16** `2916e577ef54` — 7 info
  - added the optional property `capabilities/allowed_actions` to the response with the `200` status
  - added the optional property `capabilities/close_requires_evidence` to the response with the `200` status
  - added the optional property `capabilities/expires_at` to the response with the `200` status
  - added the optional property `capabilities/scope` to the response with the `200` status
  - …3 more
- **2026-08-10** `dab1a86ff461` — 1 info
  - added the new optional `query` request parameter `issue_uid`
- **2026-08-05** `1a5a27920493` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/ui/references/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.dev/kenn-io/apis/kata/revisions/8524b3f37543?raw)