> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Relations

> List relations on an issue.

## Overview

Returns the relations to and from this issue. Each item carries `direction` (`outgoing` or `incoming`) and the related issue's `triage_id` and `title` denormalized for display.

***

## Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

***

## Path Parameters

<ParamField path="id" type="string" required>
  Internal UUID of the issue.
</ParamField>

***

## Query Parameters

<ParamField query="limit" type="integer" default="50">
  Number of relations to return. Minimum 1, maximum 100.
</ParamField>

<ParamField query="cursor" type="string">
  Opaque cursor returned as `next_cursor` from a previous page.
</ParamField>

***

## Response

<ResponseField name="data.items" type="array">
  Array of relations. See [Link Related Issue](/api-v1/post/triage-issues-id-relations#response) for the field list.
</ResponseField>

<ResponseField name="data.next_cursor" type="string | null">
  Cursor for the next page, or `null`.
</ResponseField>

<ResponseField name="errors" type="null | array">
  `null` on success. Returns 404 if the issue does not exist.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "items": [
        {
          "id": "172c839b-130d-4712-a09c-b767a78542ea",
          "org_id": "f5b40b9e-bc05-4b8a-9af1-d8f6a8a3a201",
          "issue_id": "9bbe5547-d5b1-4b83-9f80-87c4af7c6b34",
          "related_issue_id": "849ee9ce-be6b-4f9c-8e55-2736aeeb579f",
          "related_triage_id": "T-1004",
          "related_title": "Caller transferred to wrong queue",
          "relation_type": "duplicate_of",
          "direction": "outgoing",
          "created_by_id": "75c5c7da-a5d6-4e26-a51e-1ae8ef2bfa4a",
          "created_at": "2026-05-07T05:28:29.358Z"
        }
      ],
      "next_cursor": null
    },
    "errors": null
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)