Skip to main content
curl -X GET "https://api.omophub.com/v1/vocabularies/search?query=SNOMED" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "vocabulary_id": "SNOMED",
      "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
      "vocabulary_reference": "SNOMED International",
      "vocabulary_version": "2024-07-01",
      "vocabulary_concept": 45756746,
      "description": "Comprehensive clinical terminology for electronic health records",
      "domains": ["Condition", "Procedure", "Observable Entity", "Substance"],
      "concept_count": 4567891,
      "is_active": true,
      "last_updated": "2024-07-01T00:00:00Z",
      "match_score": 0.98
    },
    {
      "vocabulary_id": "SNOMEDCT_US",
      "vocabulary_name": "SNOMED CT US Extension",
      "vocabulary_reference": "National Library of Medicine",
      "vocabulary_version": "2024-07-01",
      "vocabulary_concept": 45756747,
      "description": "US-specific extensions and modifications to SNOMED CT",
      "domains": ["Condition", "Procedure", "Observable Entity"],
      "concept_count": 12456,
      "is_active": true,
      "last_updated": "2024-07-01T00:00:00Z",
      "match_score": 0.92
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_items": 2,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    },
    "search_info": {
      "query": "SNOMED",
      "execution_time": "12ms",
      "total_vocabularies_scanned": 156
    },
    "request_id": "req_vocab_search_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}

​
Overview

Search for vocabularies by name, description, or metadata. This endpoint provides flexible search capabilities to find relevant vocabularies for your use case.

​
Query Parameters

​
query
string
required
Search query string. Searches across vocabulary names, descriptions, and aliases.
​
domain
string
Filter by medical domain. Options: Condition, Procedure, Drug, Observation, Measurement, Device
​
includeInactive
boolean
default:"false"
Include inactive vocabularies in search results
​
limit
integer
default:"20"
Maximum number of results to return (max: 100)
​
offset
integer
default:"0"
Number of results to skip for pagination
curl -X GET "https://api.omophub.com/v1/vocabularies/search?query=SNOMED" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "vocabulary_id": "SNOMED",
      "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
      "vocabulary_reference": "SNOMED International",
      "vocabulary_version": "2024-07-01",
      "vocabulary_concept": 45756746,
      "description": "Comprehensive clinical terminology for electronic health records",
      "domains": ["Condition", "Procedure", "Observable Entity", "Substance"],
      "concept_count": 4567891,
      "is_active": true,
      "last_updated": "2024-07-01T00:00:00Z",
      "match_score": 0.98
    },
    {
      "vocabulary_id": "SNOMEDCT_US",
      "vocabulary_name": "SNOMED CT US Extension",
      "vocabulary_reference": "National Library of Medicine",
      "vocabulary_version": "2024-07-01",
      "vocabulary_concept": 45756747,
      "description": "US-specific extensions and modifications to SNOMED CT",
      "domains": ["Condition", "Procedure", "Observable Entity"],
      "concept_count": 12456,
      "is_active": true,
      "last_updated": "2024-07-01T00:00:00Z",
      "match_score": 0.92
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_items": 2,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    },
    "search_info": {
      "query": "SNOMED",
      "execution_time": "12ms",
      "total_vocabularies_scanned": 156
    },
    "request_id": "req_vocab_search_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}
⌘I