curl -X GET "https://api.omophub.com/v1/vocabularies/search?query=SNOMED" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies/search",
params={"query": "SNOMED"},
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
for vocab in data["data"]:
print(f"{vocab['vocabulary_id']}: {vocab['vocabulary_name']}")
import { OMOPHub } from '@omophub/omophub-node';
// Not yet exposed as a dedicated SDK method — use the typed low-level helper.
const client = new OMOPHub();
const { data } = await client.get<Array<{ vocabulary_id: string; vocabulary_name: string }>>(
'/vocabularies/search',
{ query: { query: 'SNOMED' } },
);
data?.forEach(vocab => {
console.log(`${vocab.vocabulary_id}: ${vocab.vocabulary_name}`);
});
curl -X GET "https://api.omophub.com/v1/vocabularies/search?query=drug&include_inactive=true&page_size=50" \
-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 Vocabularies
Search across OMOP vocabulary names and descriptions to find the right terminology - SNOMED, LOINC, ICD-10, and the full OHDSI-supported catalog.
curl -X GET "https://api.omophub.com/v1/vocabularies/search?query=SNOMED" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies/search",
params={"query": "SNOMED"},
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
for vocab in data["data"]:
print(f"{vocab['vocabulary_id']}: {vocab['vocabulary_name']}")
import { OMOPHub } from '@omophub/omophub-node';
// Not yet exposed as a dedicated SDK method — use the typed low-level helper.
const client = new OMOPHub();
const { data } = await client.get<Array<{ vocabulary_id: string; vocabulary_name: string }>>(
'/vocabularies/search',
{ query: { query: 'SNOMED' } },
);
data?.forEach(vocab => {
console.log(`${vocab.vocabulary_id}: ${vocab.vocabulary_name}`);
});
curl -X GET "https://api.omophub.com/v1/vocabularies/search?query=drug&include_inactive=true&page_size=50" \
-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
Search query string. Searches across vocabulary names and descriptions.
Page number for pagination (1-based).
Number of results per page (max 100).
Include inactive vocabularies in search results.
Specific vocabulary release version to query
Example:
Example:
2025.1Response
Indicates if the request was successful.
Array of matching vocabulary objects.
Show Vocabulary Object
Show Vocabulary Object
Response metadata.
Show Metadata Object
Show Metadata Object
Unique identifier for this request.
Vocabulary release version used.
Response timestamp (ISO format).
curl -X GET "https://api.omophub.com/v1/vocabularies/search?query=SNOMED" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies/search",
params={"query": "SNOMED"},
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
for vocab in data["data"]:
print(f"{vocab['vocabulary_id']}: {vocab['vocabulary_name']}")
import { OMOPHub } from '@omophub/omophub-node';
// Not yet exposed as a dedicated SDK method — use the typed low-level helper.
const client = new OMOPHub();
const { data } = await client.get<Array<{ vocabulary_id: string; vocabulary_name: string }>>(
'/vocabularies/search',
{ query: { query: 'SNOMED' } },
);
data?.forEach(vocab => {
console.log(`${vocab.vocabulary_id}: ${vocab.vocabulary_name}`);
});
curl -X GET "https://api.omophub.com/v1/vocabularies/search?query=drug&include_inactive=true&page_size=50" \
-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
Basic Search
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
Related Endpoints
- List Vocabularies - List all vocabularies
- Get Vocabulary - Get specific vocabulary details
Was this page helpful?
⌘I