sortby parameter

Save PDF

Last Updated: May 13, 2026
1 minute read

Semaphore
Documentation

The sortBy parameter specifies how objects are sorted when they are returned. The following table describes the valid parameter values for each object type.

Object type	Valid values
Models	`name`: Sorts models by their name `version`: Sorts models by their version
Concept schemes	`id`: Sorts concept schemes by their ID `uri`: Sorts concept schemes by their URI
Concepts	`id`: Sorts concepts by their ID `uri`: Sorts concepts by their URI `prefLabels` : Sorts concepts by their preferred labels

Configuring ascending or descending order

By default, objects are sorted in ascending order; however, you can set the sortDirection option to descending to sort by descending order.

Sorting concepts by prefLabel

When sorting concepts by preferred labels (concepts?sortBy=prefLabel), you can use the sortLang parameter to specify languages in priority order. For example, sortLang=en,fr sorts by English labels first, and then French. Note:

If sortLang is not passed, the prefLabels/value in the concepts.labels.defaultLanguage property is used to specify the sorting priority order of languages.
In both configuration scenarios, language-neutral labels are always used to sort last.

Example

The following is an example of the sorting the concept schemes by URI in descending order:

http://<base_url>/models/SpaceMissions/conceptschemes?sortBy=uri&sortDirection=descending

Semaphore Concepts Service