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

{
  "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
​
meta
object
required
Response metadata
curl -X GET "https://api.omophub.com/v1/concepts/201826/related?min_score=0.4&page_size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "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