Get Related Concepts

curl -X GET "https://api.omophub.com/v1/concepts/201826/related?min_score=0.4&page_size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

concept_id = 201826  # Type 2 diabetes
url = f"https://api.omophub.com/v1/concepts/{concept_id}/related"
params = {
    "min_score": 0.4,
    "page_size": 30,
    "relationship_types": "Is a,Maps to"
}

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

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

print(f"Found {len(data['data'])} related concepts")

for related in data['data'][:5]:
    print(f"  - {related['concept_name']} ({related['vocabulary_id']})")
    print(f"    Relationship: {related['relationship_name']}")
    print(f"    Score: {related['relationship_score']:.2f}")

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

const client = new OMOPHub();
const conceptId = 201826; // Type 2 diabetes
const { data } = await client.concepts.related(conceptId, {
  minScore: 0.3,
  pageSize: 20,
});

console.log(`Found ${data?.length ?? 0} related concepts`);

data?.slice(0, 5).forEach((concept, index) => {
  console.log(`${index + 1}. ${concept.concept_name} (${concept.vocabulary_id})`);
  console.log(`   Relationship: ${concept.relationship_name}`);
  console.log(`   Score: ${concept.relationship_score.toFixed(2)}`);
});

{
  "success": true,
  "data": [
    {
      "concept_id": 73211009,
      "concept_name": "Diabetes mellitus",
      "concept_code": "73211009",
      "vocabulary_id": "SNOMED",
      "vocabulary_name": "SNOMED CT",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "relationship_id": "Is a",
      "relationship_name": "Is a",
      "relationship_score": 0.95,
      "relationship_distance": 1
    },
    {
      "concept_id": 443735,
      "concept_name": "Type 2 diabetes mellitus without complications",
      "concept_code": "443735",
      "vocabulary_id": "SNOMED",
      "vocabulary_name": "SNOMED CT",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "relationship_id": "Subsumes",
      "relationship_name": "Subsumes",
      "relationship_score": 0.87,
      "relationship_distance": 1
    },
    {
      "concept_id": 435216,
      "concept_name": "Type 2 diabetes mellitus",
      "concept_code": "E11",
      "vocabulary_id": "ICD10CM",
      "vocabulary_name": "ICD10CM",
      "domain_id": "Condition",
      "concept_class_id": "ICD10 code",
      "standard_concept": null,
      "relationship_id": "Maps to",
      "relationship_name": "Maps to",
      "relationship_score": 0.92,
      "relationship_distance": 1
    }
  ],
  "meta": {
    "request_id": "req_related_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.1"
  }
}

curl -X GET "https://api.omophub.com/v1/concepts/201826/related?min_score=0.4&page_size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

concept_id = 201826  # Type 2 diabetes
url = f"https://api.omophub.com/v1/concepts/{concept_id}/related"
params = {
    "min_score": 0.4,
    "page_size": 30,
    "relationship_types": "Is a,Maps to"
}

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

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

print(f"Found {len(data['data'])} related concepts")

for related in data['data'][:5]:
    print(f"  - {related['concept_name']} ({related['vocabulary_id']})")
    print(f"    Relationship: {related['relationship_name']}")
    print(f"    Score: {related['relationship_score']:.2f}")

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

const client = new OMOPHub();
const conceptId = 201826; // Type 2 diabetes
const { data } = await client.concepts.related(conceptId, {
  minScore: 0.3,
  pageSize: 20,
});

console.log(`Found ${data?.length ?? 0} related concepts`);

data?.slice(0, 5).forEach((concept, index) => {
  console.log(`${index + 1}. ${concept.concept_name} (${concept.vocabulary_id})`);
  console.log(`   Relationship: ${concept.relationship_name}`);
  console.log(`   Score: ${concept.relationship_score.toFixed(2)}`);
});

{
  "success": true,
  "data": [
    {
      "concept_id": 73211009,
      "concept_name": "Diabetes mellitus",
      "concept_code": "73211009",
      "vocabulary_id": "SNOMED",
      "vocabulary_name": "SNOMED CT",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "relationship_id": "Is a",
      "relationship_name": "Is a",
      "relationship_score": 0.95,
      "relationship_distance": 1
    },
    {
      "concept_id": 443735,
      "concept_name": "Type 2 diabetes mellitus without complications",
      "concept_code": "443735",
      "vocabulary_id": "SNOMED",
      "vocabulary_name": "SNOMED CT",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "relationship_id": "Subsumes",
      "relationship_name": "Subsumes",
      "relationship_score": 0.87,
      "relationship_distance": 1
    },
    {
      "concept_id": 435216,
      "concept_name": "Type 2 diabetes mellitus",
      "concept_code": "E11",
      "vocabulary_id": "ICD10CM",
      "vocabulary_name": "ICD10CM",
      "domain_id": "Condition",
      "concept_class_id": "ICD10 code",
      "standard_concept": null,
      "relationship_id": "Maps to",
      "relationship_name": "Maps to",
      "relationship_score": 0.92,
      "relationship_distance": 1
    }
  ],
  "meta": {
    "request_id": "req_related_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.1"
  }
}

Overview

This endpoint finds concepts that are related to a given concept through various relationship types. Results are scored and ordered by relationship strength.

Path Parameters

conceptId

integer

required

The unique OMOP concept ID to find related concepts for

Query Parameters

page_size

integer

default:"20"

Maximum number of related concepts to return (1-100)

min_score

number

default:"0.1"

Minimum relationship score (0.0-1.0) to include in results

relationship_types

string

Comma-separated list of relationship types to filter by (e.g., “Is a,Maps to”)

vocab_release

string

Specific vocabulary release version (e.g., “2025.1”)

Response

success

boolean

required

Indicates if the request was successful

data

array

required

Array of related concepts ordered by relationship score

Show data

concept_id

integer

Related concept ID

concept_name

string

Related concept name

concept_code

string

Related concept code

vocabulary_id

string

Related concept vocabulary ID

vocabulary_name

string

Related concept vocabulary name

domain_id

string

Related concept domain

concept_class_id

string

Related concept class

standard_concept

string

Standard concept flag (“S” for standard, “C” for classification, null for non-standard)

relationship_id

string

Relationship type ID (e.g., “Is a”, “Maps to”)

relationship_name

string

Human-readable relationship name

relationship_score

number

Relationship strength score (0.0-1.0)

relationship_distance

integer

Number of relationship steps from source concept

meta

object

required

Response metadata

Show meta

request_id

string

Unique request identifier

timestamp

string

ISO 8601 timestamp

vocab_release

string

Vocabulary release version used

curl -X GET "https://api.omophub.com/v1/concepts/201826/related?min_score=0.4&page_size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

concept_id = 201826  # Type 2 diabetes
url = f"https://api.omophub.com/v1/concepts/{concept_id}/related"
params = {
    "min_score": 0.4,
    "page_size": 30,
    "relationship_types": "Is a,Maps to"
}

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

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

print(f"Found {len(data['data'])} related concepts")

for related in data['data'][:5]:
    print(f"  - {related['concept_name']} ({related['vocabulary_id']})")
    print(f"    Relationship: {related['relationship_name']}")
    print(f"    Score: {related['relationship_score']:.2f}")

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

const client = new OMOPHub();
const conceptId = 201826; // Type 2 diabetes
const { data } = await client.concepts.related(conceptId, {
  minScore: 0.3,
  pageSize: 20,
});

console.log(`Found ${data?.length ?? 0} related concepts`);

data?.slice(0, 5).forEach((concept, index) => {
  console.log(`${index + 1}. ${concept.concept_name} (${concept.vocabulary_id})`);
  console.log(`   Relationship: ${concept.relationship_name}`);
  console.log(`   Score: ${concept.relationship_score.toFixed(2)}`);
});

{
  "success": true,
  "data": [
    {
      "concept_id": 73211009,
      "concept_name": "Diabetes mellitus",
      "concept_code": "73211009",
      "vocabulary_id": "SNOMED",
      "vocabulary_name": "SNOMED CT",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "relationship_id": "Is a",
      "relationship_name": "Is a",
      "relationship_score": 0.95,
      "relationship_distance": 1
    },
    {
      "concept_id": 443735,
      "concept_name": "Type 2 diabetes mellitus without complications",
      "concept_code": "443735",
      "vocabulary_id": "SNOMED",
      "vocabulary_name": "SNOMED CT",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "relationship_id": "Subsumes",
      "relationship_name": "Subsumes",
      "relationship_score": 0.87,
      "relationship_distance": 1
    },
    {
      "concept_id": 435216,
      "concept_name": "Type 2 diabetes mellitus",
      "concept_code": "E11",
      "vocabulary_id": "ICD10CM",
      "vocabulary_name": "ICD10CM",
      "domain_id": "Condition",
      "concept_class_id": "ICD10 code",
      "standard_concept": null,
      "relationship_id": "Maps to",
      "relationship_name": "Maps to",
      "relationship_score": 0.92,
      "relationship_distance": 1
    }
  ],
  "meta": {
    "request_id": "req_related_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.1"
  }
}

Usage Examples

Find general related concepts:

curl -X GET "https://api.omophub.com/v1/concepts/201826/related" \
  -H "Authorization: Bearer YOUR_API_KEY"

High-Score Relationships

Get only strongly related concepts:

curl -X GET "https://api.omophub.com/v1/concepts/201826/related?min_score=0.7&page_size=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filtered by Relationship Type

Find specific relationship types:

curl -X GET "https://api.omophub.com/v1/concepts/201826/related?relationship_types=Is%20a,Maps%20to" \
  -H "Authorization: Bearer YOUR_API_KEY"

Important Notes

Score interpretation - Scores above 0.7 indicate strong relationships, 0.4-0.7 moderate, below 0.4 weak
Distance interpretation - Distance of 1 means direct relationship, higher values indicate indirect connections
Performance - Results are cached for improved response times on repeated queries

Get Concept Relationships - Get all direct relationships
Traverse Relationships - Complex relationship traversals

Get Relationship Options Get Trending Concepts

API Reference

Search

Concepts

Concept Hierarchy

Mappings

FHIR Resolver

Relationships

Domains & Classifications

Vocabularies

Overview

Path Parameters

Query Parameters

Response

Usage Examples

High-Score Relationships

Filtered by Relationship Type

Important Notes

​Overview

​Path Parameters

​Query Parameters

​Response

​Usage Examples

​Basic Related Concepts

​High-Score Relationships

​Filtered by Relationship Type

​Important Notes

​Related Endpoints

Overview

Path Parameters

Query Parameters

Response

Usage Examples

Basic Related Concepts

High-Score Relationships

Filtered by Relationship Type

Important Notes

Related Endpoints