---
title: "List issue relations"
method: GET
path: "/api/v1/issues/{code}/relations"
tags: ["issues"]
---

# List issue relations

`GET /api/v1/issues/{code}/relations`

## Request

- Base URL: `https://api.capy.ai`
- URL: `https://api.capy.ai/api/v1/issues/{code}/relations`
- Auth: HTTP bearer

## Path parameters

- `code` string, required

## Query parameters

- `offset` string
- `limit` string

## Response `200`

IssueRelationPage

- IssueRelationPageEncoded
  - `items` IssueRelationEncoded[], required
    - `relation` union, required: How the listed issue relates to the one in the path: `blocks` means the path issue blocks it, `blocked_by` that it blocks the path issue.
      - 'blocked_by' | 'blocks' | 'related'
      - string
    - `issue` IssueEncoded, required
      - `id` string, required
      - `code` string, required
      - `number` integer, required
      - `projectId` string, required
      - `title` string, required
      - `state` IssueStateRefEncoded, required
        - `id` string, required
        - `name` string, required
        - `type` union, required
          - 'open' | 'closed'
          - string
      - `priority` union, required
        - 'urgent' | 'high' | 'normal' | 'low'
        - string
      - `dueAt` string, nullable, required
      - `parentId` string, nullable, required
      - `visibility` union, required
        - 'org' | 'private'
        - string
      - `assignees` IssueActorEncoded[], required
        - `kind` union, required
          - 'user' | 'thread'
          - string
        - `id` string, required: A user id for `user`, resolved by `GET /users`, or a thread id for `thread`.
        - `code` string, nullable, required: The thread's reference, such as `SCO-123`; null for a user or a thread the key cannot read.
      - `labels` IssueLabelRefEncoded[], required
        - `id` string, required
        - `name` string, required
      - `subIssueCount` integer, required
      - `closedSubIssueCount` integer, required
      - `openBlockerCount` integer, required: Open issues the key can read that block this one.
      - `createdAt` string, required
      - `updatedAt` string, required
      - `closedAt` string, nullable, required
  - `total` integer, required

## Other responses

- `400`: capy/InvalidRequest
- `401`: capy/Unauthorized
- `403`: capy/Forbidden
- `404`: capy/IssueNotFound
- `429`: capy/RateLimited

## Changes

- **2026-10-31** `e3be47264feb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/capy/apis/capy-api/changes/api/v1/issues/:code/relations/get.md)

---

[API](https://skmtc.dev/capy/apis/capy-api.md) - [All operations](https://skmtc.dev/capy/apis/capy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/capy/apis/capy-api/revisions/4663f7dc4e39?raw)