Skip to main content

​
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 (1-100 characters)
​
vocabulary_ids
string
Filter search to specific vocabularies (comma-separated)
Examples: SNOMED, SNOMED,ICD10CM, RXNORM,NDC
​
domain_ids
string
Filter by medical domains (comma-separated)
Examples: Condition, Condition,Procedure, Drug,Device
​
page
integer
default:"1"
Page number (1-based indexing)
​
page_size
integer
default:"20"
Number of results per page (max: 1000)
​
vocab_release
string
Specific vocabulary release version to query
Example: 2025.1
curl -X GET "https://api.omophub.com/v1/search/concepts?query=hypertension&page_size=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": {
      "query": "hypertension",
      "total_results": 247,
      "filters_applied": {
        "vocabulary_ids": ["SNOMED", "ICD10CM"]
      }
    },
    "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.