Skip to main content
GET
/
v1
/
datasets
/
lineage
/
{datasetId}
Get Dataset Lineage
curl --request GET \
  --url https://api.truthlocks.com/v1/datasets/lineage/{datasetId} \
  --header 'X-API-Key: <api-key>'
{
  "dataset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "lineage": [
    {
      "transformation": "<string>",
      "source_dataset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "timestamp": "2023-11-07T05:31:56Z"
    }
  ]
}
Returns the complete lineage graph for a dataset attestation. The graph represents the provenance chain as a directed acyclic graph (DAG) of dataset and model references connected by transformation relationships. Use dataset lineage to audit data provenance, verify that training data sources are trusted, and trace how raw data flows through preprocessing pipelines into model training.

​
Authentication

​
X-API-Key
string
required
API key with datasets:read scope. Alternatively, pass a Bearer JWT token in the Authorization header.
​
X-Tenant-ID
string
required
Tenant identifier for multi-tenant isolation.

​
Path Parameters

​
id
string
required
Dataset attestation identifier (maip-ds:ULID).

​
Response

​
dataset_id
string
The root dataset identifier for this lineage query.
​
nodes
array
Array of lineage nodes. Each node contains: - id (string) — Resource identifier (maip-ds:... or maip-model:...) - type (string) — Node type: dataset or model - name (string) — Human-readable name - version (string) — Resource version - status (string) — Current attestation status
  • created_at (string) — ISO 8601 timestamp
​
edges
array
Array of transformation relationships connecting nodes. Each edge contains: - source (string) — Source node identifier - target (string) — Target node identifier - relationship (string) — Transformation type (e.g. derived_from, trained_on, preprocessed_from, merged_from) - metadata (object) — Optional edge metadata (e.g. transformation parameters)

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

​
datasetId
string<uuid>
required

Dataset identifier

Response

Dataset lineage

​
dataset_id
string<uuid>
​
lineage
object[]