curl -X POST "https://api.omophub.com/v1/concepts/relationships/traverse" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "concept_ids": [201826],
    "traversal_params": {
      "relationship_types": ["Is a", "Maps to"],
      "max_depth": 3
    }
  }'

import requests

def traverse_relationships(concept_ids, traversal_params=None):
    url = "https://api.omophub.com/v1/concepts/relationships/traverse"
    headers = {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    }

    data = {"concept_ids": concept_ids}
    if traversal_params:
        data["traversal_params"] = traversal_params

    response = requests.post(url, json=data, headers=headers)
    return response.json()

# Example: Traverse from Type 2 diabetes
result = traverse_relationships(
    concept_ids=[201826],
    traversal_params={
        "relationship_types": ["Is a", "Subsumes", "Maps to"],
        "max_depth": 3,
        "include_paths": True
    }
)

data = result['data']
print(f"Starting concepts: {data['starting_concepts']}")
print(f"Discovered {data['traversal_summary']['total_discovered']} concepts")
print(f"Max distance: {data['traversal_summary']['max_distance_reached']}")

for concept in data['discovered_concepts'][:5]:
    print(f"  - {concept['concept_name']} (distance: {concept['distance']})")

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

// Not yet exposed as a dedicated SDK method - use the typed low-level helper.
const client = new OMOPHub();

interface TraversalResult {
  starting_concepts: number[];
  traversal_summary: { total_discovered: number; max_distance_reached: number };
  discovered_concepts: Array<{ concept_name: string; distance: number }>;
}

const { data } = await client.post<TraversalResult>('/concepts/relationships/traverse', {
  concept_ids: [201826],
  traversal_params: { relationship_types: ['Is a', 'Maps to'], max_depth: 3 },
});

console.log(`Discovered ${data?.traversal_summary.total_discovered} concepts`);

data?.discovered_concepts.slice(0, 5).forEach(concept => {
  console.log(`- ${concept.concept_name} (distance: ${concept.distance})`);
});