Skip to main content
curl -X GET "https://api.omophub.com/v1/search/concepts?query=hypertension&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "concept_id": 320128,
      "concept_name": "Essential hypertension",
      "concept_code": "59621000",
      "vocabulary_id": "SNOMED",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "match_score": 0.95,
      "match_type": "exact",
      "valid_start_date": "1970-01-01",
      "valid_end_date": "2099-12-31"
    },
    {
      "concept_id": 316866,
      "concept_name": "Hypertensive disorder",
      "concept_code": "38341003",
      "vocabulary_id": "SNOMED",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "match_score": 0.89,
      "match_type": "partial",
      "valid_start_date": "1970-01-01",
      "valid_end_date": "2099-12-31"
    },
    {
      "concept_id": 4124681,
      "concept_name": "Accelerated hypertension",
      "concept_code": "48146000",
      "vocabulary_id": "SNOMED",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "match_score": 0.85,
      "match_type": "fuzzy",
      "valid_start_date": "1970-01-01",
      "valid_end_date": "2099-12-31"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 10,
      "total_items": 247,
      "total_pages": 25,
      "has_next": true,
      "has_previous": false
    },
    "search_info": {
      "query": "hypertension",
      "execution_time": "23ms",
      "vocabularies_searched": ["SNOMED", "ICD10CM"],
      "total_concepts_scanned": 156789
    },
    "request_id": "req_search_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}

​
Overview

Search for medical concepts using text queries. This endpoint provides fast, relevant results across all supported vocabularies using advanced search algorithms.

​
Query Parameters

​
query
string
required
Search query text (minimum 2 characters)
​
vocabulary
string
Limit search to specific vocabulary (e.g., “SNOMED”, “ICD10CM”)
​
domain
string
Filter by medical domain (e.g., “Condition”, “Procedure”, “Drug”)
​
conceptClass
string
Filter by concept class
​
includeInvalid
boolean
default:"false"
Include invalid/deprecated concepts in results
​
limit
integer
default:"50"
Maximum number of results (max: 1000)
​
offset
integer
default:"0"
Number of results to skip for pagination
curl -X GET "https://api.omophub.com/v1/search/concepts?query=hypertension&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "concept_id": 320128,
      "concept_name": "Essential hypertension",
      "concept_code": "59621000",
      "vocabulary_id": "SNOMED",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "match_score": 0.95,
      "match_type": "exact",
      "valid_start_date": "1970-01-01",
      "valid_end_date": "2099-12-31"
    },
    {
      "concept_id": 316866,
      "concept_name": "Hypertensive disorder",
      "concept_code": "38341003",
      "vocabulary_id": "SNOMED",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "match_score": 0.89,
      "match_type": "partial",
      "valid_start_date": "1970-01-01",
      "valid_end_date": "2099-12-31"
    },
    {
      "concept_id": 4124681,
      "concept_name": "Accelerated hypertension",
      "concept_code": "48146000",
      "vocabulary_id": "SNOMED",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "match_score": 0.85,
      "match_type": "fuzzy",
      "valid_start_date": "1970-01-01",
      "valid_end_date": "2099-12-31"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 10,
      "total_items": 247,
      "total_pages": 25,
      "has_next": true,
      "has_previous": false
    },
    "search_info": {
      "query": "hypertension",
      "execution_time": "23ms",
      "vocabularies_searched": ["SNOMED", "ICD10CM"],
      "total_concepts_scanned": 156789
    },
    "request_id": "req_search_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}

​
Search Features

​
1. Fuzzy Matching

Handles typos and misspellings automatically. Finds conceptually similar terms even with different wording.

​
3. Relevance Scoring

Results ranked by relevance with match scores.

​
4. Multi-vocabulary

Searches across all vocabularies simultaneously.

​
5. Fast Performance

Optimized for sub-second response times.

​
Common Use Cases

​
1. Clinical Coding

Find appropriate codes for clinical documentation.

​
2. Data Standardization

Map free-text clinical notes to standard concepts.

​
3. Quality Assurance

Validate and standardize existing coded data.

​
4. Research Applications

Find concepts for cohort definitions and outcome measures.
⌘I