---
title: "tool si.read.lineage"
description: "an artefact: its whole history and footprint, marking unavailable what a store cannot answer."
section: reference
address: /reference/tools/si-read-lineage
contract: 0476e35e6e275db5
---

# tool si.read.lineage

an artefact: its whole history and footprint, marking unavailable what a store cannot answer.

[figure: Over MCP, si.read.lineage takes LineageInput and returns a card whose body is Lineage.]

its whole history and footprint, marking unavailable what a store cannot answer. The call needs the read grant at the strategy rung.



| | |
|---|---|
| input | [LineageInput](/concepts/lineageinput) |
| result | a card whose body is [Lineage](/concepts/lineage) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/Lineage` |
| HTTP route | [`/v1/read/lineage`](/reference/read/lineage) |





| field | type | required | note |
|---|---|---|---|
| `artefact_hash` | `hash` | no |  |
| `unit` | `id` | no |  |