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
string
required
Search query string. Searches across vocabulary names and descriptions.
integer
default:"1"
Page number for pagination (1-based).
integer
default:"20"
Number of results per page (max 100).
boolean
default:"false"
Include inactive vocabularies in search results.
string
Specific vocabulary release version to query
Example:
Example:
2025.1Response
boolean
Indicates if the request was successful.
array
object
Response metadata.
Show Metadata Object
Show Metadata Object
string
Unique identifier for this request.
string
Vocabulary release version used.
string
Response timestamp (ISO format).
object
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