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": "US Edition 20240301",
      "vocabulary_concept_id": 45756746
    },
    {
      "vocabulary_id": "Nebraska Lexicon",
      "vocabulary_name": "Nebraska Lexicon",
      "vocabulary_reference": "University of Nebraska",
      "vocabulary_version": "2024-01",
      "vocabulary_concept_id": 32675
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "vocab_release": "2025.1",
    "timestamp": "2025-01-05T10:00:00Z",
    "search": {
      "query": "SNOMED",
      "total_results": 2,
      "filters_applied": {
        "search_type": "full_text_search",
        "include_inactive": false
      }
    },
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_items": 2,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    }
  }
}
Search for vocabularies by name or description. Returns matching vocabularies with relevance scoring.

​
Query Parameters

​
query
string
required
Search query string. Searches across vocabulary names and descriptions.
​
page
integer
default:"1"
Page number for pagination (1-based).
​
page_size
integer
default:"20"
Number of results per page (max 100).
​
include_inactive
boolean
default:"false"
Include inactive vocabularies in search results.
​
vocab_release
string
Specific vocabulary release version to query
Example: 2025.1

​
Response

​
success
boolean
Indicates if the request was successful.
​
data
array
Array of matching vocabulary objects.
​
meta
object
Response metadata.
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": "US Edition 20240301",
      "vocabulary_concept_id": 45756746
    },
    {
      "vocabulary_id": "Nebraska Lexicon",
      "vocabulary_name": "Nebraska Lexicon",
      "vocabulary_reference": "University of Nebraska",
      "vocabulary_version": "2024-01",
      "vocabulary_concept_id": 32675
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "vocab_release": "2025.1",
    "timestamp": "2025-01-05T10:00:00Z",
    "search": {
      "query": "SNOMED",
      "total_results": 2,
      "filters_applied": {
        "search_type": "full_text_search",
        "include_inactive": false
      }
    },
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_items": 2,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    }
  }
}

​
Usage Examples

Search for vocabularies by name: 
GET /v1/vocabularies/search?query=SNOMED

​
With Pagination

Search with custom page size: 
GET /v1/vocabularies/search?query=ICD&page=1&page_size=50

​
Include Inactive

Include deprecated vocabularies: 
GET /v1/vocabularies/search?query=classification&include_inactive=true