---
title: "Get cross-tool lineage"
method: GET
path: "/api/v1/assets/{assetH}/cross-tool-lineage"
tags: ["Assets"]
---

# Get cross-tool lineage

`GET /api/v1/assets/{assetH}/cross-tool-lineage`

## Request

- Base URL: `https://numonic.ai`
- URL: `https://numonic.ai/api/v1/assets/{assetH}/cross-tool-lineage`
- Auth: API key in header `x-api-key`

Retrieve the lineage graph for an asset across creative tools. Each node reports the tool it came from (midjourney, comfyui or unknown). Returns empty node and edge lists when the asset has no lineage.

## Path parameters

- `assetH` string, required: Asset hash (40-char hex SHA-1)

## Query parameters

- `max_depth` integer: Maximum number of hops to traverse (default 10)

## Response `200`

Lineage retrieved

- object
  - `asset_h` string, required: Requested asset hash
  - `nodes` object[], required
    - `depth` integer, required
    - `asset_h` string, required
    - `parent_asset_h` string, nullable, required
    - `relationship_type` string, nullable, required
    - `source_tool` 'midjourney' | 'comfyui' | 'unknown', required
    - `title` string, nullable, required
    - `filename` string, nullable, required
    - `thumbnail_path` string, nullable, required
  - `edges` object[], required
    - `from` string, required
    - `to` string, required
    - `relationship_type` string, nullable, required

## Other responses

- `400`: Invalid asset hash or max_depth
- `401`: Missing or invalid credentials
- `429`: Rate limit exceeded

---

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