Overview
Efficiently retrieve information for multiple concepts at once. This endpoint is optimized for bulk operations and reduces the number of API calls needed.Request Body
Array of concept IDs to retrieve (max: 1000)
Include relationships for all concepts
Include synonyms for all concepts
Include cross-vocabulary mappings for all concepts
Filter results to specific vocabularies
Only return standard concepts
Copy
curl -X POST "https://api.omophub.com/v1/concepts/batch" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"concept_ids": [320128, 201826, 4329847],
"include_relationships": true,
"include_synonyms": true
}'
Copy
{
"success": true,
"data": {
"concepts": [
{
"concept_id": 320128,
"concept_name": "Essential hypertension",
"concept_code": "59621000",
"vocabulary_id": "SNOMED",
"domain_id": "Condition",
"concept_class_id": "Clinical Finding",
"standard_concept": "S",
"valid_start_date": "1970-01-01",
"valid_end_date": "2099-12-31",
"invalid_reason": null,
"synonyms": [
{
"concept_synonym_name": "Primary hypertension",
"language_concept_id": 4180186,
"language_concept_name": "English"
},
{
"concept_synonym_name": "Idiopathic hypertension",
"language_concept_id": 4180186,
"language_concept_name": "English"
}
],
"relationships": [
{
"relationship_id": "Is a",
"target_concept_id": 316866,
"target_concept_name": "Hypertensive disorder",
"target_vocabulary_id": "SNOMED",
"relationship_direction": "outbound"
}
]
},
{
"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",
"valid_start_date": "1970-01-01",
"valid_end_date": "2099-12-31",
"invalid_reason": null,
"synonyms": [
{
"concept_synonym_name": "Type II diabetes mellitus",
"language_concept_id": 4180186,
"language_concept_name": "English"
},
{
"concept_synonym_name": "Adult-onset diabetes",
"language_concept_id": 4180186,
"language_concept_name": "English"
}
],
"relationships": [
{
"relationship_id": "Is a",
"target_concept_id": 73211009,
"target_concept_name": "Diabetes mellitus",
"target_vocabulary_id": "SNOMED",
"relationship_direction": "outbound"
}
]
},
{
"concept_id": 4329847,
"concept_name": "Myocardial infarction",
"concept_code": "22298006",
"vocabulary_id": "SNOMED",
"domain_id": "Condition",
"concept_class_id": "Clinical Finding",
"standard_concept": "S",
"valid_start_date": "1970-01-01",
"valid_end_date": "2099-12-31",
"invalid_reason": null,
"synonyms": [
{
"concept_synonym_name": "Heart attack",
"language_concept_id": 4180186,
"language_concept_name": "English"
},
{
"concept_synonym_name": "MI - Myocardial infarction",
"language_concept_id": 4180186,
"language_concept_name": "English"
}
],
"relationships": [
{
"relationship_id": "Is a",
"target_concept_id": 134057,
"target_concept_name": "Acute myocardial infarction",
"target_vocabulary_id": "SNOMED",
"relationship_direction": "inbound"
}
]
}
],
"failed_concepts": [],
"summary": {
"total_requested": 3,
"successful_retrievals": 3,
"failed_retrievals": 0,
"vocabularies_represented": ["SNOMED"],
"domains_represented": ["Condition"]
}
},
"meta": {
"request_id": "req_batch_123",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2",
"query_time_ms": 45.2
}
}