---
title: "Get tree graph for a collection"
method: GET
path: "/public/v1/network/{collectionId}/tree-graph"
tags: ["Collections - Network"]
deprecated: true
---

# Get tree graph for a collection

`GET /public/v1/network/{collectionId}/tree-graph`

> **Deprecated.**

⚠️ **DEPRECATED** - This endpoint is deprecated and will be removed at the end of December 2026.

**Note**: Responses include a `Sunset` HTTP header (RFC 8594) indicating the removal date.

---

Retrieve a hierarchical tree structure showing supplier relationships within a collection.

This endpoint returns a tree graph representing the supply chain network, showing how suppliers
are connected through multiple tiers. Each node in the tree represents a target (supplier/customer),
and edges represent relationships between them.

**Use Cases**:
- Visualize supplier network structure
- Analyze supply chain depth and breadth
- Identify direct and indirect suppliers
- Map relationships across multiple tiers

**Filtering Options**:
- **commodityIds**: Filter results to include only targets associated with specific commodities
- **commodityTreeId**: Filter using a predefined commodity tree
- **tierLevel**: Limit the depth of the tree (maximum 4 tiers)
- **fetchParents**: Include parent organizations in the results

**Response Format**:
Returns an array of tree nodes, where each node contains:
- Target information
- Supplier relationships (nested structure)
- Tier information
- Edge source information

**Required Permissions**: `ACCESS_PUBLIC_TREE_GRAPH` and `READ` on the collection

**Performance Impact**: High

## Path parameters

- `collectionId` integer, required

## Query parameters

- `commodityIds` integer[]
- `commodityTreeId` integer
- `fetchParents` boolean
- `tierLevel` integer

## Response `200`

OK

## Other responses

- `403` — 403 Forbidden - Authentication or authorization failure. This status code is returned when: (1) the request lacks valid authentication credentials (missing or invalid X-Auth-Token header), or (2) the authenticated user does not have the required permission to access this resource.
- `429` — 429 Too Many Requests - API rate limit exceeded. The request has been rejected because the rate limit for this endpoint has been exceeded. Default rate limits: GET requests - 100 per 10 seconds, 500 per minute; POST/PUT/PATCH/DELETE requests - 20 per 10 seconds, 100 per minute. For increased access, please contact customer success.
- `500` — 500 Internal Server Error - An unexpected error occurred on the server. The request may or may not have been processed.

---

[API](https://skmtc.net/prewave/apis/public-prewave-api.md) · [All operations](https://skmtc.net/prewave/apis/public-prewave-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prewave/public-prewave-api/revisions/466169815b78/schema)