---
title: "List relationships"
method: GET
path: "/entities/{id}/relationships"
tags: ["entities"]
---

# List relationships

`GET /entities/{id}/relationships`

Retrieves all relationships associated with a specific Entities.
This includes parent, child, and linked entities.
Use this endpoint to understand how an entity is connected within the product hierarchy or planning structure.

The source entity is implicit (this entity).

## Path parameters

- `id` string, uuid, required — A universally unique identifier (UUID).

## Query parameters

- `type` 'parent' | 'child' | 'link' | 'isBlockedBy' | 'isBlocking' — The type of the relationship to be established. ## Relationships - `parent`: Hierarchical relationship indicating the entity is a child of the target - `child`: Hierarchical relationship indicating the entity contains the target - `link`: Generic bidirectional relationship without semantic meaning - `isBlockedBy`: Dependency relationship indicating the entity cannot proceed until the target is resolved - `isBlocking`: Dependency relationship indicating the entity prevents progress on the target
- `target[type]` 'product' | 'component' | 'feature' | 'subfeature' | 'initiative' | 'objective' | 'keyResult' | 'release' | 'releaseGroup' | 'company' | 'user' — Supported Entity types: - product - component - feature - subfeature - initiative - objective - keyResult - release - releaseGroup - company - user The exact types available may vary based on the configuration of the workspace.
- `target[id]` string, uuid — A universally unique identifier (UUID).
- `pageCursor` string

## Response `200`

A paginated list of relationships

- object
  - `data` EntityRelationship[]
    - `type` 'parent' | 'child' | 'link' | 'isBlockedBy' | 'isBlocking', required — The type of the relationship to be established. ## Relationships - `parent`: Hierarchical relationship indicating the entity is a child of the target - `child`: Hierarchical relationship indicating the entity contains the target - `link`: Generic bidirectional relationship without semantic meaning - `isBlockedBy`: Dependency relationship indicating the entity cannot proceed until the target is resolved - `isBlocking`: Dependency relationship indicating the entity prevents progress on the target
    - `target` ResourceReference, required — # Description A common response object of entity reference. # Validation # Filtering
      - `id` string, uuid, required — A universally unique identifier (UUID).
      - `type` 'product' | 'component' | 'feature' | 'subfeature' | 'initiative' | 'objective' | 'keyResult' | 'release' | 'releaseGroup' | 'company' | 'user', required — Supported Entity types: - product - component - feature - subfeature - initiative - objective - keyResult - release - releaseGroup - company - user The exact types available may vary based on the configuration of the workspace.
      - `links` EntityLinks
        - `self` string, required
        - `html` string, nullable, required — Deep link to the entity in the Productboard web UI. Null when the parent space has no domain configured (e.g. newly-onboarded spaces or replays).
  - `links` ListLinks
    - `next` string, nullable, required

## Other responses

- `400` — Bad Request - Invalid input format or malformed request
- `401` — Unauthorized - Missing or invalid authentication credentials
- `403` — Forbidden - Insufficient permissions
- `404` — Not Found - The requested resource does not exist or is not accessible
- `408` — Request Timeout - The server did not receive a complete request within the allowed time
- `429` — Too Many Requests - API rate limit exceeded, reduce request frequency and retry after the indicated time
- `500` — Internal Server Error - An unexpected error occurred on the server, please retry or contact support

---

[API](https://skmtc.dev/productboard/apis/notes.md) · [All operations](https://skmtc.dev/productboard/apis/notes/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/productboard/notes/revisions/b4004749b60f/schema)