curl -X GET "https://api.omophub.com/v1/concepts/320128" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/concepts/320128",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
concept = response.json()
import { OMOPHub } from '@omophub/omophub-node';
const client = new OMOPHub();
const { data: concept } = await client.concepts.get(320128);
curl -X GET "https://api.omophub.com/v1/concepts/320128?include_relationships=true&include_synonyms=true" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
params = {
"include_relationships": True,
"include_synonyms": True
}
response = requests.get(
"https://api.omophub.com/v1/concepts/320128",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params=params
)
concept = response.json()
{
"success": true,
"data": {
"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,
"is_valid": true,
"is_standard": true,
"is_classification": false,
"synonyms": [
"Primary hypertension",
"Idiopathic hypertension",
"High blood pressure"
],
"relationships": {
"parents": [
{
"concept_id": 316866,
"concept_name": "Hypertensive disorder",
"relationship_id": "Is a"
}
],
"children": [
{
"concept_id": 4124681,
"concept_name": "Accelerated hypertension",
"relationship_id": "Subsumes"
}
]
}
},
"meta": {
"request_id": "req_concept_123",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2"
}
}
Get Concept
curl -X GET "https://api.omophub.com/v1/concepts/320128" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/concepts/320128",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
concept = response.json()
import { OMOPHub } from '@omophub/omophub-node';
const client = new OMOPHub();
const { data: concept } = await client.concepts.get(320128);
curl -X GET "https://api.omophub.com/v1/concepts/320128?include_relationships=true&include_synonyms=true" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
params = {
"include_relationships": True,
"include_synonyms": True
}
response = requests.get(
"https://api.omophub.com/v1/concepts/320128",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params=params
)
concept = response.json()
{
"success": true,
"data": {
"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,
"is_valid": true,
"is_standard": true,
"is_classification": false,
"synonyms": [
"Primary hypertension",
"Idiopathic hypertension",
"High blood pressure"
],
"relationships": {
"parents": [
{
"concept_id": 316866,
"concept_name": "Hypertensive disorder",
"relationship_id": "Is a"
}
],
"children": [
{
"concept_id": 4124681,
"concept_name": "Accelerated hypertension",
"relationship_id": "Subsumes"
}
]
}
},
"meta": {
"request_id": "req_concept_123",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2"
}
}
Overview
Retrieve comprehensive information about a medical concept using its unique concept ID. This endpoint provides full concept details including synonyms, relationships, and classification information.Path Parameters
integer
required
The unique concept identifier (e.g., 320128 for “Essential hypertension”)
Query Parameters
string
Specific vocabulary release to use (e.g., “2025.2”). Uses latest if not
specified.
boolean
default:"false"
Include related concepts (parents, children, mappings)
boolean
default:"false"
Include all synonyms and alternative names
boolean
default:"false"
Include ancestor and descendant concepts in hierarchy
boolean
default:"true"
Include concepts with invalid_reason set (deprecated/updated concepts). Set to
false to only return valid concepts.
curl -X GET "https://api.omophub.com/v1/concepts/320128" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/concepts/320128",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
concept = response.json()
import { OMOPHub } from '@omophub/omophub-node';
const client = new OMOPHub();
const { data: concept } = await client.concepts.get(320128);
curl -X GET "https://api.omophub.com/v1/concepts/320128?include_relationships=true&include_synonyms=true" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
params = {
"include_relationships": True,
"include_synonyms": True
}
response = requests.get(
"https://api.omophub.com/v1/concepts/320128",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params=params
)
concept = response.json()
Response Fields
boolean
Whether the lookup succeeded.
object
Concept record.
integer
OMOP concept identifier.
string
Primary concept name.
string
Source vocabulary code.
string
Vocabulary identifier.
string
OMOP domain.
string
Concept class.
string | null
S, C, or null.string
Validity start date.
string
Validity end date.
string | null
Invalidity marker, or null.
boolean
Derived validity flag.
boolean
Whether this is a standard concept.
boolean
Whether this is a classification concept.
array
Published synonym strings when requested.
object
Relationship groups when requested.
array
Parent concepts with
concept_id, concept_name, and relationship_id.array
Child concepts with
concept_id, concept_name, and relationship_id.object
Request metadata.
string
Request correlation ID.
string
Response timestamp.
string
Vocabulary release used.
{
"success": true,
"data": {
"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,
"is_valid": true,
"is_standard": true,
"is_classification": false,
"synonyms": [
"Primary hypertension",
"Idiopathic hypertension",
"High blood pressure"
],
"relationships": {
"parents": [
{
"concept_id": 316866,
"concept_name": "Hypertensive disorder",
"relationship_id": "Is a"
}
],
"children": [
{
"concept_id": 4124681,
"concept_name": "Accelerated hypertension",
"relationship_id": "Subsumes"
}
]
}
},
"meta": {
"request_id": "req_concept_123",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2"
}
}
Common Use Cases
1. Clinical Decision Support
Get concept details for clinical coding and documentation systems.2. Data Validation
Verify concept information during data quality checks.3. User Interface Display
Show detailed concept information in healthcare applications.4. Relationship Analysis
Understand concept hierarchies and mappings for analysis.Related Endpoints
- Get Concept by Code - Look up concept using vocabulary-specific code
- Get Concept Relationships - Get all relationships for a concept
- Search Concepts - Search for concepts by name or description
Was this page helpful?