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

# GET /api/v1/projects/{project_id}/issues/{ref}

`GET /api/v1/projects/{project_id}/issues/{ref}`

## Path parameters

- `project_id` integer, required
- `ref` string, required

## Query parameters

- `include_deleted` boolean

## Response `200`

OK

- ShowIssueResponseBody
  - `children` IssueOut[]
    - `assignment_expires_on` string, date-time
    - `author` string, required
    - `blocked` boolean
    - `blocked_by` LinkPeer[]
      - `project` string, required
      - `qualified_id` string, required
      - `short_id` string, required
      - `status` string, required
      - `uid` string, required
    - `blocks` LinkPeer[]
      - `project` string, required
      - `qualified_id` string, required
      - `short_id` string, required
      - `status` string, required
      - `uid` string, required
    - `body` string, required
    - `child_counts` ChildCounts
      - `open` integer, required
      - `total` integer, required
    - `closed_at` string, date-time
    - `closed_reason` string
    - `created_at` string, date-time, required
    - `deleted_at` string, date-time
    - `id` integer, required
    - `labels` string[]
    - `metadata` object, required
    - `occurrence_key` string
    - `owner` string
    - `parent` LinkPeer
      - `project` string, required
      - `qualified_id` string, required
      - `short_id` string, required
      - `status` string, required
      - `uid` string, required
    - `priority` integer
    - `project_id` integer, required
    - `project_uid` string
    - `qualified_id` string, required
    - `recurrence_id` integer
    - `related` LinkPeer[]
      - `project` string, required
      - `qualified_id` string, required
      - `short_id` string, required
      - `status` string, required
      - `uid` string, required
    - `revision` integer, required
    - `short_id` string, required
    - `status` string, required
    - `title` string, required
    - `uid` string, required
    - `updated_at` string, date-time, required
    - `web_url` string — Browser URL for this issue in the owning daemon.
  - `claim` IssueClaimOut
    - `acquired_at` string, date-time, required
    - `claim_kind` string, required
    - `claim_uid` string, required
    - `client_kind` string, required
    - `expires_at` string, date-time
    - `holder` string, required
    - `holder_instance_uid` string, required
    - `issue_uid` string, required
    - `project_id` integer, required
    - `purpose` string, required
    - `release_reason` string
    - `released_at` string, date-time
    - `revision` integer, required
    - `updated_at` string, date-time, required
  - `claim_hub_now` string, date-time
  - `claim_violation_count` integer
  - `claim_violations` ClaimViolationOut[]
    - `actor` string
    - `at` string, date-time, required
    - `event_id` integer, required
    - `event_uid` string, required
    - `issue_uid` string, required
    - `offending_event_type` string
    - `offending_event_uid` string
    - `offending_origin_instance_uid` string
    - `reason` string
    - `short_id` string
  - `comments` Comment[], required
    - `author` string, required
    - `body` string, required
    - `created_at` string, date-time, required
    - `id` integer, required
    - `issue_id` integer, required
    - `teammate` string
    - `uid` string, required
  - `issue` Issue, required
    - `assignment_expires_on` string, date-time
    - `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
  - `labels` IssueLabel[], required
    - `author` string, required
    - `created_at` string, date-time, required
    - `issue_id` integer, required
    - `label` string, required
  - `lease` IssueClaimOut
    - `acquired_at` string, date-time, required
    - `claim_kind` string, required
    - `claim_uid` string, required
    - `client_kind` string, required
    - `expires_at` string, date-time
    - `holder` string, required
    - `holder_instance_uid` string, required
    - `issue_uid` string, required
    - `project_id` integer, required
    - `purpose` string, required
    - `release_reason` string
    - `released_at` string, date-time
    - `revision` integer, required
    - `updated_at` string, date-time, required
  - `lease_hub_now` string, date-time
  - `lease_violation_count` integer
  - `lease_violations` ClaimViolationOut[]
    - `actor` string
    - `at` string, date-time, required
    - `event_id` integer, required
    - `event_uid` string, required
    - `issue_uid` string, required
    - `offending_event_type` string
    - `offending_event_uid` string
    - `offending_origin_instance_uid` string
    - `reason` string
    - `short_id` string
  - `links` LinkOut[], required
    - `author` string, required
    - `created_at` string, date-time, required
    - `from` LinkPeer, required
      - `project` string, required
      - `qualified_id` string, required
      - `short_id` string, required
      - `status` string, required
      - `uid` string, required
    - `id` integer, required
    - `to` LinkPeer, required
      - `project` string, required
      - `qualified_id` string, required
      - `short_id` string, required
      - `status` string, required
      - `uid` string, required
    - `type` string, required
  - `parent` IssueRef
    - `qualified_id` string, required
    - `short_id` string, required
    - `status` string, required
    - `title` string, required
    - `uid` string, required
  - `pending_claims` PendingClaimOut[]
    - `claim_kind` string, required
    - `client_kind` string, required
    - `holder` string, required
    - `holder_instance_uid` string, required
    - `last_attempt_at` string, date-time
    - `last_error` string
    - `purpose` string
    - `request_uid` string, required
    - `requested_at` string, date-time, required
    - `ttl_seconds` integer
  - `pending_leases` PendingClaimOut[]
    - `claim_kind` string, required
    - `client_kind` string, required
    - `holder` string, required
    - `holder_instance_uid` string, required
    - `last_attempt_at` string, date-time
    - `last_error` string
    - `purpose` string
    - `request_uid` string, required
    - `requested_at` string, date-time, required
    - `ttl_seconds` integer
  - `web_url` string — Browser URL for this issue in the owning daemon.

## Other responses

- `default` — Error

## Changes

- **2026-09-19** `62eb7bbfff42` — 2 info
  - added the optional property `children/items/assignment_expires_on` to the response with the `200` status
  - added the optional property `issue/assignment_expires_on` to the response with the `200` status
- **2026-09-15** `94934a712d64` — 2 info
  - added the optional property `children/items/web_url` to the response with the `200` status
  - added the optional property `web_url` to the response with the `200` status
- **2026-09-15** `d55881e28f7f` — 1 info
  - added the optional property `comments/items/teammate` to the response with the `200` status
- **2026-07-09** `987b717e44b2` — 7 info
  - added the optional property `children/items/blocked` to the response with the `200` status
  - added the required property `children/items/blocked_by/items/status` to the response with the `200` status
  - added the required property `children/items/blocks/items/status` to the response with the `200` status
  - added the required property `children/items/parent/status` to the response with the `200` status
  - …3 more
- …earlier changes not shown

[Full history](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/projects/:project_id/issues/:ref/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)