Skip to main content

Overview

This endpoint returns basic hierarchical positioning information for a concept, including its depth from root concepts and counts of ancestors and descendants.

Path Parameters

conceptId
integer
required
The unique OMOP concept ID to get level information for

Query Parameters

vocab_release
string
Specific vocabulary release version (e.g., β€œ2025.1”)

Response

success
boolean
required
Indicates whether the request was successful
data
object
required
Response data containing concept level information
meta
object
required
Response metadata and API information

Usage Examples

Basic Level Information

Get hierarchy level for a concept:

With Specific Vocabulary Version

Get level information for a specific vocabulary release:

Important Notes

  • Depth interpretation - depth_from_root indicates how many β€œIs a” relationship steps exist between this concept and the root
  • Descendant count - total_descendants includes all child concepts at any depth below
  • Ancestor count - total_ancestors includes all parent concepts up to the root