---
title: "Field-level lineage for one column on one table"
method: GET
path: "/v1/tables/{name}/columns/{col}/lineage"
tags: ["Lineage"]
---

# Field-level lineage for one column on one table

`GET /v1/tables/{name}/columns/{col}/lineage`

## Request

- Base URL: `https://api.rossdata.dev`
- URL: `https://api.rossdata.dev/v1/tables/{name}/columns/{col}/lineage`
- Auth: none declared

Field lineage scoped to a single TABLE.COL: which fields populate it and which it feeds, with the program(s) carrying each flow and direct/via-local + guard/loop tags. Same edge shape as /v1/columns/{name}/lineage.

## Path parameters

- `name` string, required
- `col` string, required

## Response `200`

OK

- FieldLineage: Field-level lineage for a column. scope=field for an exact TABLE.COL; scope=schema-wide for a bare column (aggregated across every table carrying it, in `fields`). Edges appear under populatedFrom (in) and feeds (out).
  - `scope` 'field' | 'schema-wide'
  - `schema` string
  - `field` string
  - `column` string
  - `tableCount` integer: schema-wide only: tables carrying this column that have lineage
  - `counts` object
    - `populatedFrom` integer
    - `feeds` integer
  - `populatedFrom` FieldLineageEdge[]
    - `field` string
    - `table` string
    - `column` string
    - `tag` 'direct' | 'via-local': direct = single-statement rhs field ref; via-local = recovered through a #local def-use closure
    - `confidence` 'EXTRACTED' | 'INFERRED'
    - `programs` string[]: Programs that carry the flow (up to 6 shown)
    - `programCount` integer
    - `guarded` boolean: Present when the write only ever fires inside a conditional
    - `inLoop` boolean: Present when the write was seen inside a loop body
  - `feeds` FieldLineageEdge[]
    - `field` string
    - `table` string
    - `column` string
    - `tag` 'direct' | 'via-local': direct = single-statement rhs field ref; via-local = recovered through a #local def-use closure
    - `confidence` 'EXTRACTED' | 'INFERRED'
    - `programs` string[]: Programs that carry the flow (up to 6 shown)
    - `programCount` integer
    - `guarded` boolean: Present when the write only ever fires inside a conditional
    - `inLoop` boolean: Present when the write was seen inside a loop body
  - `fields` object[]: schema-wide only: per-table lineage nodes

## Other responses

- `404`: No field lineage for that column

---

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