curl -X POST "https://api.omophub.com/v1/concepts/hierarchy/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "queries": [
      {
        "query_id": "q1",
        "concept_id": 201826,
        "operation": "ancestors",
        "params": {
          "max_levels": 5
        }
      },
      {
        "query_id": "q2",
        "concept_id": 4182210,
        "operation": "descendants",
        "params": {
          "max_levels": 3
        }
      },
      {
        "query_id": "q3",
        "concept_id": 313217,
        "operation": "hierarchy",
        "params": {
          "max_levels": 4,
          "relationship_types": ["Is a"]
        }
      }
    ]
  }'

import requests

def batch_hierarchy_query(queries, api_key):
    url = "https://api.omophub.com/v1/concepts/hierarchy/batch"
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    }
    data = {"queries": queries}

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

# Example usage
queries = [
    {
        "query_id": "diabetes",
        "concept_id": 201826,
        "operation": "ancestors",
        "params": {"max_levels": 5}
    },
    {
        "query_id": "hypertension",
        "concept_id": 4182210,
        "operation": "descendants",
        "params": {"max_levels": 3}
    },
    {
        "query_id": "afib",
        "concept_id": 313217,
        "operation": "hierarchy",
        "params": {"max_levels": 4}
    }
]

result = batch_hierarchy_query(queries, "YOUR_API_KEY")

for query_result in result['data']['results']:
    if query_result['success']:
        data = query_result['data']
        ancestors = len(data.get('ancestors', []))
        descendants = len(data.get('descendants', []))
        print(f"{query_result['query_id']}: {ancestors} ancestors, {descendants} descendants")
    else:
        print(f"{query_result['query_id']}: Error - {query_result['error']}")

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

// Not yet exposed as a dedicated SDK method — use the typed low-level helper
// for parity with auth, retries, and error handling.
const client = new OMOPHub();

interface HierarchyQueryResult {
  results: Array<{
    query_id: string;
    success: boolean;
    data?: { ancestors?: unknown[]; descendants?: unknown[] };
    error?: string;
  }>;
}

const { data } = await client.post<HierarchyQueryResult>('/concepts/hierarchy/batch', {
  queries: [
    { query_id: 'q1', concept_id: 201826, operation: 'ancestors', params: { max_levels: 5 } },
    { query_id: 'q2', concept_id: 4182210, operation: 'descendants', params: { max_levels: 3 } },
    { query_id: 'q3', concept_id: 313217, operation: 'hierarchy', params: { max_levels: 4 } },
  ],
});

data?.results.forEach((queryResult) => {
  if (queryResult.success) {
    const ancestors = queryResult.data?.ancestors?.length ?? 0;
    const descendants = queryResult.data?.descendants?.length ?? 0;
    console.log(`${queryResult.query_id}: ${ancestors} ancestors, ${descendants} descendants`);
  } else {
    console.error(`${queryResult.query_id} failed: ${queryResult.error}`);
  }
});