The subset API is implemented under the subset/ namespace. It is an entity-based API.
Info
Gets SubsetInfo for a named subset.
URL
/subset/[name]
Examples
- Diseases subset
Members
Lists all the concepts in a named subset, or lists sub-trees within a subset.
URL
/subset/[name]/members
Parameters
concepts One more optional concept ids. If provided, only these concepts and their children within the selected subset will be returned. If this parameter is repeated, the result will be the union of all the subtrees.
Examples
- All members of the Diseases subset
- Just Parkinson's disease and its children
Hierarchy
Provides the concept hierarchy for an entire subset, or specific sub-trees within a subset.
The response to this function is a list of concept ids. Each pair of concept ids in the response represents an edge from a child concept to a parent. For each concept in the subset that does not have any parents, a self-edge is included in the response. The hierarchy is multi-parented and guaranteed to be non-cyclical (there are no loops in the concept graph).
URL
/subset/[name]/hierarchy
Parameters
concepts One more optional concept ids. If provided, only these concepts and their children within the selected subset will be returned. If this parameter is repeated, the result will be the union of all the subtrees.
Examples
- The hierarchy of the Diseases subset
- Just Parkinson's disease and its children