obscyro

Api / Descendants

/v1/concepts/{code}/descendants

Walk every transitive child of a SNOMED concept via the is-a hierarchy.

GET/v1/concepts/{code}/descendants

Returns all descendant concepts of {code} reachable via active is-a (116680003) relationships, computed with a recursive CTE. Use this to build cohorts (e.g. "every kind of cardiovascular disease") without having to materialize the hierarchy yourself.

Quick reference

Path parameters

  • codestringrequired

    SCTID of the root concept.

Query parameters

  • limitintegeroptionaldefault: 100

    Maximum descendants to return, between 1 and 10,000. Response sets truncated: true when more exist.

  • includeNamesbooleanoptionaldefault: false

    When true, each result is hydrated with its preferredTerm.

Coming soon

Full reference with response schema, examples in cURL/Node/Python, and edge cases is being written. The endpoint is live and stable today.