curl -X GET "https://api.omophub.com/v1/vocabularies" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
for vocab in data["data"]["vocabularies"]:
print(f"{vocab['vocabulary_id']}: {vocab['vocabulary_name']}")
import { OMOPHub } from '@omophub/omophub-node';
const client = new OMOPHub();
const { data } = await client.vocabularies.list();
data?.vocabularies.forEach(vocab => {
console.log(`${vocab.vocabulary_id}: ${vocab.vocabulary_name}`);
});
curl -X GET "https://api.omophub.com/v1/vocabularies?include_stats=true&sort_by=name&sort_order=asc&page_size=50" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies",
params={
"include_stats": True,
"sort_by": "name",
"sort_order": "asc",
"page_size": 50
},
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
{
"success": true,
"data": {
"vocabularies": [
{
"vocabulary_id": "SNOMED",
"vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
"vocabulary_reference": "SNOMED CT",
"vocabulary_version": "US Edition 20240301",
"vocabulary_concept_id": 45756746,
"concept_count": 354652,
"standard_concept_count": 298456
},
{
"vocabulary_id": "ICD10CM",
"vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
"vocabulary_reference": "CMS",
"vocabulary_version": "2024",
"vocabulary_concept_id": 45756681,
"concept_count": 95678,
"standard_concept_count": 0
},
{
"vocabulary_id": "LOINC",
"vocabulary_name": "Logical Observation Identifiers Names and Codes",
"vocabulary_reference": "Regenstrief Institute",
"vocabulary_version": "2.76",
"vocabulary_concept_id": 45756747,
"concept_count": 260142,
"standard_concept_count": 226941
},
{
"vocabulary_id": "RxNorm",
"vocabulary_name": "RxNorm",
"vocabulary_reference": "National Library of Medicine",
"vocabulary_version": "2024-03-04",
"vocabulary_concept_id": 45756748,
"concept_count": 125634,
"standard_concept_count": 108742
}
]
},
"meta": {
"request_id": "req_abc123",
"vocab_release": "2025.1",
"timestamp": "2025-01-05T10:00:00Z",
"pagination": {
"page": 1,
"page_size": 20,
"total_items": 25,
"total_pages": 2,
"has_next": true,
"has_previous": false
}
}
}
List Vocabularies
Get a paginated list of all available OMOP medical vocabularies - SNOMED CT, ICD-10, LOINC, RxNorm, ATC, HCPCS, and 120+ OHDSI-supported terminologies.
curl -X GET "https://api.omophub.com/v1/vocabularies" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
for vocab in data["data"]["vocabularies"]:
print(f"{vocab['vocabulary_id']}: {vocab['vocabulary_name']}")
import { OMOPHub } from '@omophub/omophub-node';
const client = new OMOPHub();
const { data } = await client.vocabularies.list();
data?.vocabularies.forEach(vocab => {
console.log(`${vocab.vocabulary_id}: ${vocab.vocabulary_name}`);
});
curl -X GET "https://api.omophub.com/v1/vocabularies?include_stats=true&sort_by=name&sort_order=asc&page_size=50" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies",
params={
"include_stats": True,
"sort_by": "name",
"sort_order": "asc",
"page_size": 50
},
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
{
"success": true,
"data": {
"vocabularies": [
{
"vocabulary_id": "SNOMED",
"vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
"vocabulary_reference": "SNOMED CT",
"vocabulary_version": "US Edition 20240301",
"vocabulary_concept_id": 45756746,
"concept_count": 354652,
"standard_concept_count": 298456
},
{
"vocabulary_id": "ICD10CM",
"vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
"vocabulary_reference": "CMS",
"vocabulary_version": "2024",
"vocabulary_concept_id": 45756681,
"concept_count": 95678,
"standard_concept_count": 0
},
{
"vocabulary_id": "LOINC",
"vocabulary_name": "Logical Observation Identifiers Names and Codes",
"vocabulary_reference": "Regenstrief Institute",
"vocabulary_version": "2.76",
"vocabulary_concept_id": 45756747,
"concept_count": 260142,
"standard_concept_count": 226941
},
{
"vocabulary_id": "RxNorm",
"vocabulary_name": "RxNorm",
"vocabulary_reference": "National Library of Medicine",
"vocabulary_version": "2024-03-04",
"vocabulary_concept_id": 45756748,
"concept_count": 125634,
"standard_concept_count": 108742
}
]
},
"meta": {
"request_id": "req_abc123",
"vocab_release": "2025.1",
"timestamp": "2025-01-05T10:00:00Z",
"pagination": {
"page": 1,
"page_size": 20,
"total_items": 25,
"total_pages": 2,
"has_next": true,
"has_previous": false
}
}
}
This endpoint returns a paginated list of all available medical vocabularies in the system, including SNOMED CT, ICD-10-CM, LOINC, RxNorm, and others.
The counts are calculated from the selected vocabulary release. Requesting a
different
Query Parameters
integer
default:"1"
Page number for pagination (1-based).
integer
default:"20"
Number of vocabularies to return per page. Values above 200 are clamped to
200.
boolean
default:"false"
Include release-scoped concept and standard-concept counts for each
vocabulary. Counts reflect the selected release.
string
default:"name"
Sort field. Options:
name, priority, updatedstring
default:"asc"
Sort order. Options:
asc, descstring
Specific vocabulary release version (e.g., “2025.1”). Defaults to the latest
available release.
Response
boolean
Indicates if the request was successful.
object
Response data container.
Show Data Object
Show Data Object
array
Array of vocabulary objects.
Show Vocabulary Object
Show Vocabulary Object
string
Unique identifier for the vocabulary (e.g., “SNOMED”, “ICD10CM”).
string
Full name of the vocabulary.
string
Reference or source organization for the vocabulary.
string
Version identifier of the vocabulary.
integer
OMOP concept ID representing this vocabulary.
integer
Total number of concepts in this vocabulary for the selected release.
Returned when
include_stats=true; this matches
GET /v1/vocabularies/{vocabularyId}/stats.total_concepts.integer
Number of standard concepts in this vocabulary for the selected release.
Returned when
include_stats=true.object
Response metadata and pagination information.
Show Metadata Object
Show Metadata Object
string
Unique identifier for this request.
string
Vocabulary release version used.
string
Response timestamp (ISO format).
curl -X GET "https://api.omophub.com/v1/vocabularies" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
for vocab in data["data"]["vocabularies"]:
print(f"{vocab['vocabulary_id']}: {vocab['vocabulary_name']}")
import { OMOPHub } from '@omophub/omophub-node';
const client = new OMOPHub();
const { data } = await client.vocabularies.list();
data?.vocabularies.forEach(vocab => {
console.log(`${vocab.vocabulary_id}: ${vocab.vocabulary_name}`);
});
curl -X GET "https://api.omophub.com/v1/vocabularies?include_stats=true&sort_by=name&sort_order=asc&page_size=50" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies",
params={
"include_stats": True,
"sort_by": "name",
"sort_order": "asc",
"page_size": 50
},
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
{
"success": true,
"data": {
"vocabularies": [
{
"vocabulary_id": "SNOMED",
"vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
"vocabulary_reference": "SNOMED CT",
"vocabulary_version": "US Edition 20240301",
"vocabulary_concept_id": 45756746,
"concept_count": 354652,
"standard_concept_count": 298456
},
{
"vocabulary_id": "ICD10CM",
"vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
"vocabulary_reference": "CMS",
"vocabulary_version": "2024",
"vocabulary_concept_id": 45756681,
"concept_count": 95678,
"standard_concept_count": 0
},
{
"vocabulary_id": "LOINC",
"vocabulary_name": "Logical Observation Identifiers Names and Codes",
"vocabulary_reference": "Regenstrief Institute",
"vocabulary_version": "2.76",
"vocabulary_concept_id": 45756747,
"concept_count": 260142,
"standard_concept_count": 226941
},
{
"vocabulary_id": "RxNorm",
"vocabulary_name": "RxNorm",
"vocabulary_reference": "National Library of Medicine",
"vocabulary_version": "2024-03-04",
"vocabulary_concept_id": 45756748,
"concept_count": 125634,
"standard_concept_count": 108742
}
]
},
"meta": {
"request_id": "req_abc123",
"vocab_release": "2025.1",
"timestamp": "2025-01-05T10:00:00Z",
"pagination": {
"page": 1,
"page_size": 20,
"total_items": 25,
"total_pages": 2,
"has_next": true,
"has_previous": false
}
}
}
Usage Examples
Basic List
Get all vocabularies with default pagination:GET /v1/vocabularies
With Statistics
Include concept counts for each vocabulary:GET /v1/vocabularies?include_stats=true&vocab_release=2026.2
vocab_release can therefore return different counts for the same
vocabulary.
Sorted by Name
Get vocabularies sorted alphabetically:GET /v1/vocabularies?sort_by=name&sort_order=asc
Related Endpoints
- Get Vocabulary - Get details for a specific vocabulary
- Search Vocabularies - Search vocabularies by name
- Get Vocabulary Concepts - Get concepts within a vocabulary
Was this page helpful?