---
title: "Digital Product Passport Cradle-to-Gate Lineage Builder"
method: POST
path: "/v1/tools/build_product_lineage"
tags: ["TODO_TAGS_REVIEW"]
---

# Digital Product Passport Cradle-to-Gate Lineage Builder

`POST /v1/tools/build_product_lineage`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/build_product_lineage`
- Auth: none declared

Build a cradle-to-gate supplier lineage with hash-only claims per stage (no trade secrets). Each stage carries a supplier_hash anchor, dataVersion-pinned certification, and carbon_value. Aggregates total carbon deterministically.

**Tool URL:** https://ainumbers.co/chaingraph/art-116-product-lineage-builder.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `product_id` unknown
  - `stages` object[]: type not evidenced by kernel source
    - `certification` unknown

## Response `200`

Successful tool execution result

- object
  - `depth` integer
  - `lineage` object[]
    - `anchored` boolean
    - `certification` string
    - `dataVersion` string
    - `depth` integer
    - `stage` string
  - `product_id` string
  - `total_carbon` number

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)