curl -X GET "https://api.omophub.com/v1/search/similar/44054006?vocabulary_ids=SNOMED,ICD10CM&similarity_threshold=0.8&page_size=10&include_scores=true&include_explanations=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

const client = new OMOPHub();
const { data } = await client.search.similar({
  conceptId: 44054006,
  vocabularyIds: ['SNOMED', 'ICD10CM'],
  similarityThreshold: 0.8,
  pageSize: 10,
  includeScores: true,
  includeExplanations: true,
});

import requests

url = "https://api.omophub.com/v1/search/similar/44054006"
params = {
    "vocabulary_ids": "SNOMED,ICD10CM",
    "similarity_threshold": 0.8,
    "page_size": 10,
    "include_scores": "true",
    "include_explanations": "true"
}

response = requests.get(
    url,
    params=params,
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

{
  "success": true,
  "data": {
    "source_concept": {
      "concept_id": 44054006,
      "concept_name": "Type 2 diabetes mellitus",
      "concept_code": "44054006",
      "vocabulary_id": "SNOMED",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S"
    },
    "similar_concepts": [
      {
        "concept_id": 201826,
        "concept_name": "Type 2 diabetes mellitus without complications",
        "concept_code": "E11.9",
        "vocabulary_id": "ICD10CM",
        "domain_id": "Condition",
        "concept_class_id": "4-char nonbill code",
        "similarity_score": 0.92,
        "explanation": "High similarity - more specific variant of the same condition",
        "standard_concept": null,
        "synonyms": ["Type II diabetes mellitus uncomplicated"]
      },
      {
        "concept_id": 443729,
        "concept_name": "Diabetes mellitus type 2 with hyperglycemia",
        "concept_code": "443729",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "similarity_score": 0.89,
        "explanation": "High similarity - related complication of the same condition",
        "standard_concept": "S",
        "synonyms": ["Type 2 DM with elevated glucose"]
      },
      {
        "concept_id": 432367,
        "concept_name": "Diabetes mellitus type 2 with diabetic nephropathy",
        "concept_code": "E11.21",
        "vocabulary_id": "ICD10CM",
        "domain_id": "Condition",
        "concept_class_id": "5-char billing code",
        "similarity_score": 0.86,
        "explanation": "High similarity - complication of the same condition",
        "standard_concept": null,
        "synonyms": ["Type 2 DM with kidney disease"]
      }
    ],
    "search_metadata": {
      "source_concept_id": 44054006,
      "algorithm_used": "hybrid",
      "similarity_threshold": 0.8,
      "total_candidates": 125000,
      "results_returned": 3,
      "processing_time_ms": 187
    }
  },
  "meta": {
    "request_id": "req_sim_xyz789",
    "timestamp": "2024-01-15T10:30:00Z",
    "vocab_release": "2025.1",
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_items": 3,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    },
    "search": {
      "query": "",
      "total_results": 3,
      "filters_applied": {
        "similarity_type": "concept"
      }
    }
  }
}

{
  "success": false,
  "error": {
    "code": "CONCEPT_NOT_FOUND",
    "message": "The specified concept ID does not exist",
    "details": {
      "concept_id": 99999999,
      "suggestion": "Verify the concept ID exists in the OMOP vocabularies"
    }
  }
}