latestOpenAPI 3.0.12026-08-20112309904.6 KB

466169815b78

Collections - Network

Get tree graph for a collection

⚠️ 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.


Migration Required

This endpoint has been replaced by the v1 Collections Tier-N API. Please migrate to the new endpoint:

Replacement Endpoint

Old EndpointNew EndpointPurpose
GET /public/v2/network/{collectionId}/tree-graphGET /public/v1/collections/{collectionId}/tier-n/dataGet collection-based supplier graphs

Why Migrate?

The v1 Collections Tier-N API provides significant improvements:

1. Enhanced Functionality

  • v2: Basic tree graph with limited configuration
  • v1 Tier-N: Advanced filtering through collection settings
  • v1 Tier-N: Configurable data sources (customs, media, predictions)
  • v1 Tier-N: Better control over scope (private, shared, public targets)

2. Better Performance

  • v1 Tier-N: Optimized queries for large collections
  • v1 Tier-N: More efficient data retrieval

3. Improved Documentation

  • Comprehensive examples for all endpoints
  • Detailed error response documentation
  • Clear parameter descriptions

Quick Migration Guide

Step 1: Update Endpoint URL

Before:

GET /public/v2/network/123/tree-graph?tierLevel=3

After:

GET /public/v1/collections/123/tier-n/data?tierLevel=3

Step 2: Update Response Parsing

Before: Parse PublicTreeTargetV2 structure

After: Parse PublicTierNCollectionGraphEntry structure (different format)


Required Permissions: ACCESS_PUBLIC_TREE_GRAPH and READ on the collection

Performance Impact: High

For detailed API reference and examples, see the v1 Collections Tier-N API documentation.

get/public/v2/network/{collectionId}/tree-graph

Path parameters

collectionIdinteger required

Query parameters

commodityIdsinteger[]
commodityTreeIdinteger
fetchParentsboolean
tierLevelinteger

Response

OK