GET /hierarchy
Retrieve the downwards concepts hierarchy starting at top concepts.

Supported Formats

html, ttl, rdf

Examples

GET /hierarchy.ttl
200

# omitted namespace definitions
:achievement_hobbies a skos:Concept;
                     skos:topConceptOf :scheme;
                     skos:prefLabel "Achievement hobbies"@en;
                     skos:narrower :model_building;
                     skos:narrower :gardening.
:model_building a skos:Concept;
                skos:prefLabel "Model building"@en;
                skos:narrower :model_rocketry;
:model_rocketry a skos:Concept;
                skos:prefLabel "Model rocketry"@en.
:gardening a skos:Concept;
           skos:prefLabel "Gardening"@en.

GET /hierarchy/:root
Retrieve a concept's up- or downwards hierarchy with optional siblings.

Supported Formats

html, ttl, rdf

Examples

GET /hierarchy/model_building.ttl?dir=down&depth=1

# omitted namespace definitions
:model_rocketry a skos:Concept;
                skos:prefLabel "Model rocketry"@en.
:radio-controlled_modeling a skos:Concept;
                           skos:prefLabel "Radio-controlled modeling"@en.
:scale_modeling a skos:Concept;
                skos:prefLabel "Scale modeling"@en.
:model_building a skos:Concept;
                skos:prefLabel "Model building"@en;
                skos:narrower :model_rocketry;
                skos:narrower :radio-controlled_modeling;
                skos:narrower :scale_modeling.

Params

Param name Description
dir
optional

Direction of the hierarchy.

down follow narrower from root to its leaf nodes.

up follow broader from root to its top term(s).

Validations:

  • Must be one of: down, up.

depth
optional

Number of levels of hierarchy to be included in the response

Validations:

  • Must be one of: 1, 2, 3, 4.

siblings
optional

Siblings of each node will be included even if they are not part of the hierarchy.

Validations:

  • Must be one of: 1, true.