curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/concepts?page_size=10" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies/SNOMED/concepts",
params={"page_size": 10, "standard_concept": "S"},
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
for concept in data["data"]["concepts"]:
print(f"{concept['concept_name']}: {concept['concept_id']}")
import { OMOPHub } from '@omophub/omophub-node';
const client = new OMOPHub();
const { data, meta } = await client.vocabularies.concepts('SNOMED', {
pageSize: 10,
standardConcept: 'S',
});
console.log(`Found ${meta?.pagination?.total_items} concepts`);
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/concepts?search=diabetes&standard_concept=S&page_size=20" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"data": {
"concepts": [
{
"concept_id": 201826,
"concept_name": "Type 2 diabetes mellitus",
"concept_code": "44054006",
"vocabulary_id": "SNOMED",
"domain_id": "Condition",
"concept_class_id": "Clinical Finding",
"standard_concept": "S",
"invalid_reason": null,
"valid_start_date": "2002-01-31",
"valid_end_date": "2099-12-31"
},
{
"concept_id": 201254,
"concept_name": "Hypertensive disorder",
"concept_code": "38341003",
"vocabulary_id": "SNOMED",
"domain_id": "Condition",
"concept_class_id": "Clinical Finding",
"standard_concept": "S",
"invalid_reason": null,
"valid_start_date": "2002-01-31",
"valid_end_date": "2099-12-31"
}
]
},
"meta": {
"request_id": "req_abc123",
"vocab_release": "2025.1",
"timestamp": "2025-01-05T10:00:00Z",
"pagination": {
"page": 1,
"page_size": 10,
"total_items": 125847,
"total_pages": 12585,
"has_next": true,
"has_previous": false
}
}
}
Get Vocabulary Concepts
Get concepts within a specific OMOP vocabulary with pagination - browse SNOMED, ICD-10, LOINC, RxNorm, or any of 120+ vocabulary code lists.
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/concepts?page_size=10" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies/SNOMED/concepts",
params={"page_size": 10, "standard_concept": "S"},
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
for concept in data["data"]["concepts"]:
print(f"{concept['concept_name']}: {concept['concept_id']}")
import { OMOPHub } from '@omophub/omophub-node';
const client = new OMOPHub();
const { data, meta } = await client.vocabularies.concepts('SNOMED', {
pageSize: 10,
standardConcept: 'S',
});
console.log(`Found ${meta?.pagination?.total_items} concepts`);
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/concepts?search=diabetes&standard_concept=S&page_size=20" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"data": {
"concepts": [
{
"concept_id": 201826,
"concept_name": "Type 2 diabetes mellitus",
"concept_code": "44054006",
"vocabulary_id": "SNOMED",
"domain_id": "Condition",
"concept_class_id": "Clinical Finding",
"standard_concept": "S",
"invalid_reason": null,
"valid_start_date": "2002-01-31",
"valid_end_date": "2099-12-31"
},
{
"concept_id": 201254,
"concept_name": "Hypertensive disorder",
"concept_code": "38341003",
"vocabulary_id": "SNOMED",
"domain_id": "Condition",
"concept_class_id": "Clinical Finding",
"standard_concept": "S",
"invalid_reason": null,
"valid_start_date": "2002-01-31",
"valid_end_date": "2099-12-31"
}
]
},
"meta": {
"request_id": "req_abc123",
"vocab_release": "2025.1",
"timestamp": "2025-01-05T10:00:00Z",
"pagination": {
"page": 1,
"page_size": 10,
"total_items": 125847,
"total_pages": 12585,
"has_next": true,
"has_previous": false
}
}
}
Retrieve concepts that belong to a specific vocabulary with optional filtering and pagination.
Path Parameters
string
required
The vocabulary identifier (e.g., “SNOMED”, “ICD10CM”, “LOINC”, “RxNorm”).
Query Parameters
string
Search term to filter concepts by name or code.
integer
default:"1"
Page number for pagination (1-based, max 1000). For large vocabularies, use the
search parameter to filter results instead of deep pagination.integer
default:"20"
Number of concepts per page (max 1000).
string
default:"all"
Filter by standard concept status. Options:
S (standard), C (classification), all.boolean
default:"true"
Include invalid or deprecated concepts.
boolean
default:"false"
Include concept relationships in response.
boolean
default:"false"
Include concept synonyms in response.
string
default:"name"
Sort field. Options:
name, concept_id, concept_code.string
default:"asc"
Sort order. Options:
asc, desc.string
Specific vocabulary release version to query
Example:
Example:
2025.1Response
boolean
Indicates if the request was successful.
object
Response data container.
Show Data Object
Show Data Object
array
Array of concept objects.
Show Concept Object
Show Concept Object
integer
Unique concept identifier.
string
Standard name of the concept.
string
Original code from the vocabulary.
string
Vocabulary containing this concept.
string
Domain of the concept.
string
Concept class identifier.
string|null
Standard concept designation (‘S’, ‘C’, or null).
string|null
Reason for invalidation if applicable.
string
Date when concept became valid.
string
Date when concept becomes invalid.
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).
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/concepts?page_size=10" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies/SNOMED/concepts",
params={"page_size": 10, "standard_concept": "S"},
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
for concept in data["data"]["concepts"]:
print(f"{concept['concept_name']}: {concept['concept_id']}")
import { OMOPHub } from '@omophub/omophub-node';
const client = new OMOPHub();
const { data, meta } = await client.vocabularies.concepts('SNOMED', {
pageSize: 10,
standardConcept: 'S',
});
console.log(`Found ${meta?.pagination?.total_items} concepts`);
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/concepts?search=diabetes&standard_concept=S&page_size=20" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"data": {
"concepts": [
{
"concept_id": 201826,
"concept_name": "Type 2 diabetes mellitus",
"concept_code": "44054006",
"vocabulary_id": "SNOMED",
"domain_id": "Condition",
"concept_class_id": "Clinical Finding",
"standard_concept": "S",
"invalid_reason": null,
"valid_start_date": "2002-01-31",
"valid_end_date": "2099-12-31"
},
{
"concept_id": 201254,
"concept_name": "Hypertensive disorder",
"concept_code": "38341003",
"vocabulary_id": "SNOMED",
"domain_id": "Condition",
"concept_class_id": "Clinical Finding",
"standard_concept": "S",
"invalid_reason": null,
"valid_start_date": "2002-01-31",
"valid_end_date": "2099-12-31"
}
]
},
"meta": {
"request_id": "req_abc123",
"vocab_release": "2025.1",
"timestamp": "2025-01-05T10:00:00Z",
"pagination": {
"page": 1,
"page_size": 10,
"total_items": 125847,
"total_pages": 12585,
"has_next": true,
"has_previous": false
}
}
}
Usage Examples
Basic List
Get concepts from a vocabulary:GET /v1/vocabularies/SNOMED/concepts?page_size=50
Search Within Vocabulary
Search for concepts by name:GET /v1/vocabularies/SNOMED/concepts?search=diabetes&standard_concept=S
With Sorting
Sort by concept name descending:GET /v1/vocabularies/RxNorm/concepts?sort_by=name&sort_order=desc
Include Additional Data
Include relationships and synonyms:GET /v1/vocabularies/SNOMED/concepts?include_relationships=true&include_synonyms=true
Related Endpoints
- List Vocabularies - Get all vocabularies
- Get Vocabulary - Get vocabulary details
- Get Concept - Get individual concept details
Was this page helpful?