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 Endpoint | New Endpoint | Purpose |
|---|---|---|
| GET /public/v2/network/{collectionId}/tree-graph | GET /public/v1/collections/{collectionId}/tier-n/data | Get 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