Docs Master data

Hierarchies API

Versions, drafts, validation, the aggregation diff, leaves and crosswalks. Public documentation tier · draft.

Nodes and versions

GET  /hier/{hierarchy}?as_of=2026-04-15                 -- the version valid on the date
GET  /hier/{hierarchy}/versions                          -- all versions with validity
POST /hier/{hierarchy}/drafts                            -- create a draft from the live version
POST /hier/{hierarchy}/drafts/{draft}/validate           -- orphans, empty levels, double parents, weight sums
GET  /hier/{hierarchy}/drafts/{draft}/diff?measure=revenue   -- aggregation diff per node
POST /hier/{hierarchy}/drafts/{draft}/publish   { "valid_from": "2026-04-01", "note": "Germany to Central Europe" }

Leaves and crosswalks

GET /hier/{hierarchy}/leaves?node=CEU&as_of=2026-04-15   -- golden ids under a node
GET /hier/{hierarchy}/xref                                 -- node codes per system