curl -X GET "https://api.omophub.com/v1/concepts/73211009/hierarchy?max_levels=3" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://api.omophub.com/v1/concepts/73211009/hierarchy?format=graph&max_levels=3" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

concept_id = 73211009  # Diabetes mellitus
url = f"https://api.omophub.com/v1/concepts/{concept_id}/hierarchy"
params = {
    "max_levels": 3,
    "vocabulary_ids": "SNOMED"
}

headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.get(url, params=params, headers=headers)
hierarchy_data = response.json()

print(f"Concept ID: {hierarchy_data['data']['concept_id']}")
print(f"Total ancestors: {hierarchy_data['data']['total_ancestors']}")
print(f"Total descendants: {hierarchy_data['data']['total_descendants']}")

import requests

concept_id = 73211009
url = f"https://api.omophub.com/v1/concepts/{concept_id}/hierarchy"
params = {
    "format": "graph",
    "max_levels": 3
}

headers = {"Authorization": "Bearer YOUR_API_KEY"}

response = requests.get(url, params=params, headers=headers)
graph_data = response.json()

# Use for D3.js or other visualization libraries
nodes = graph_data['data']['nodes']
edges = graph_data['data']['edges']
print(f"Nodes: {len(nodes)}, Edges: {len(edges)}")

import { OMOPHub } from '@omophub/omophub-node';

const client = new OMOPHub();
const { data: hierarchyData } = await client.hierarchy.get(73211009, { maxLevels: 3 });

console.log(`Ancestors: ${hierarchyData?.total_ancestors}`);
console.log(`Descendants: ${hierarchyData?.total_descendants}`);

const { data: graphData } = await client.hierarchy.get(73211009, {
  format: 'graph',
  maxLevels: 3,
});
// Use with D3.js force-directed graph
const { nodes, edges } = graphData ?? { nodes: [], edges: [] };

{
  "success": true,
  "data": {
    "concept_id": 73211009,
    "ancestors": [
      {
        "concept_id": 362969004,
        "concept_name": "Disorder of endocrine system",
        "concept_code": "362969004",
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "SNOMED Clinical Terms",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S",
        "level": 1,
        "min_levels_of_separation": 1,
        "max_levels_of_separation": 1,
        "relationship_id": "Is a",
        "relationship_name": "Is a"
      },
      {
        "concept_id": 64572001,
        "concept_name": "Disease",
        "concept_code": "64572001",
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "SNOMED Clinical Terms",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S",
        "level": 2,
        "min_levels_of_separation": 2,
        "max_levels_of_separation": 2,
        "relationship_id": "Is a",
        "relationship_name": "Is a"
      }
    ],
    "descendants": [
      {
        "concept_id": 44054006,
        "concept_name": "Type 2 diabetes mellitus",
        "concept_code": "44054006",
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "SNOMED Clinical Terms",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S",
        "level": 1,
        "min_levels_of_separation": 1,
        "max_levels_of_separation": 1,
        "relationship_id": "Subsumes",
        "relationship_name": "Subsumes"
      },
      {
        "concept_id": 46635009,
        "concept_name": "Type 1 diabetes mellitus",
        "concept_code": "46635009",
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "SNOMED Clinical Terms",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S",
        "level": 1,
        "min_levels_of_separation": 1,
        "max_levels_of_separation": 1,
        "relationship_id": "Subsumes",
        "relationship_name": "Subsumes"
      }
    ],
    "level": 3,
    "max_level": 5,
    "total_ancestors": 2,
    "total_descendants": 2
  },
  "meta": {
    "request_id": "req_hierarchy_123",
    "timestamp": "2024-12-22T10:30:00Z",
    "vocab_release": "2025.2"
  }
}

{
  "success": true,
  "data": {
    "concept_id": 73211009,
    "nodes": [
      {
        "id": 73211009,
        "name": "Diabetes mellitus",
        "level": 0,
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S"
      },
      {
        "id": 362969004,
        "name": "Disorder of endocrine system",
        "level": -1,
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S"
      },
      {
        "id": 44054006,
        "name": "Type 2 diabetes mellitus",
        "level": 1,
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S"
      },
      {
        "id": 46635009,
        "name": "Type 1 diabetes mellitus",
        "level": 1,
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "standard_concept": "S"
      }
    ],
    "edges": [
      {
        "from": 73211009,
        "to": 362969004,
        "relationship_id": "Is a"
      },
      {
        "from": 73211009,
        "to": 44054006,
        "relationship_id": "Subsumes"
      },
      {
        "from": 73211009,
        "to": 46635009,
        "relationship_id": "Subsumes"
      }
    ]
  },
  "meta": {
    "request_id": "req_hierarchy_456",
    "timestamp": "2024-12-22T10:30:00Z",
    "vocab_release": "2025.2"
  }
}