---
title: "List Chunk Relations"
method: GET
path: "/v3/collections/{collection_name}/chunks/{chunk_id}/relations"
tags: ["file-search"]
---

# List Chunk Relations

`GET /v3/collections/{collection_name}/chunks/{chunk_id}/relations`

List typed graph relations connected to a chunk.

## Path parameters

- `collection_name` string, required
- `chunk_id` string, required

## Query parameters

- `relation_types` string[], nullable
- `relation_direction` 'outgoing' | 'incoming' | 'both'

## Response `200`

List Chunk Relations response.

- ChunkRelationListResponseV3
  - `chunk_id` string, required
  - `relations` ChunkRelationFromV3[]
    - `relation_id` string, required
    - `source_chunk_id` string, required
    - `target_chunk_id` string, required
    - `target_document_id` string, nullable
    - `target_status` 'found' | 'missing' | 'unknown'
    - `relation_type` string, required
    - `metadata` ChunkRelationFromV3Metadata
    - `created_at` string, nullable
    - `updated_at` string, nullable

## Other responses

- `401` — Missing or invalid authentication.
- `403` — Collection is inactive.
- `404` — Collection not found.

---

[API](https://skmtc.dev/runcaptain/apis/api-reference.md) · [All operations](https://skmtc.dev/runcaptain/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runcaptain/api-reference/revisions/fe4649e3f4aa/schema)