---
title: "Get a document's lineage"
method: GET
path: "/v1/documents/{id}/lineage"
tags: ["Documents"]
---

# Get a document's lineage

`GET /v1/documents/{id}/lineage`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/documents/{id}/lineage`
- Auth: HTTP bearer

The document's downstream footprint ("used in"): the pipelines that consumed it, the data products built from them, the field-registry concepts it contributed, and the cases and business cases it belongs to. Each entry carries a deep link to its public surface.

## Path parameters

- `id` string, uuid, required

## Response `200`

Document lineage.

- object
  - `document_id` string, uuid
  - `pipelines` object[]
  - `data_products` object[]
  - `field_registry` object
    - `total` integer
    - `by_tier` object[]
    - `sample` object[]
  - `cases` object[]
  - `business_cases` object[]

## Other responses

- `401`: Missing or invalid API key.
- `404`: The requested resource was not found.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)