curl -X GET "https://api.omophub.com/v1/concepts/by-code/SNOMED/59621000" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/concepts/by-code/SNOMED/59621000",
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.getByCode('SNOMED', '59621000');
curl -X GET "https://api.omophub.com/v1/concepts/by-code/ICD10CM/I10" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/concepts/by-code/ICD10CM/I10",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
icd_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-01T00:00:00.000Z",
"valid_end_date": "2099-12-31T00:00:00.000Z",
"invalid_reason": null,
"is_valid": true,
"is_standard": true,
"is_classification": false
},
"meta": {
"request_id": "req_concept_code_123",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2"
}
}
{
"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-01T00:00:00.000Z",
"valid_end_date": "2099-12-31T00:00:00.000Z",
"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_code_123",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2"
}
}
Get Concept by Code
curl -X GET "https://api.omophub.com/v1/concepts/by-code/SNOMED/59621000" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/concepts/by-code/SNOMED/59621000",
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.getByCode('SNOMED', '59621000');
curl -X GET "https://api.omophub.com/v1/concepts/by-code/ICD10CM/I10" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/concepts/by-code/ICD10CM/I10",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
icd_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-01T00:00:00.000Z",
"valid_end_date": "2099-12-31T00:00:00.000Z",
"invalid_reason": null,
"is_valid": true,
"is_standard": true,
"is_classification": false
},
"meta": {
"request_id": "req_concept_code_123",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2"
}
}
{
"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-01T00:00:00.000Z",
"valid_end_date": "2099-12-31T00:00:00.000Z",
"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_code_123",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2"
}
}
Overview
Retrieve concept information using the vocabulary-specific code instead of the universal concept ID. This is useful when working with source data that contains original codes.Path Parameters
string
required
The vocabulary identifier (e.g., “SNOMED”, “ICD10CM”, “LOINC”)
string
required
The vocabulary-specific code (e.g., “59621000” for SNOMED, “I10” for ICD10CM)
curl -X GET "https://api.omophub.com/v1/concepts/by-code/SNOMED/59621000" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/concepts/by-code/SNOMED/59621000",
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.getByCode('SNOMED', '59621000');
curl -X GET "https://api.omophub.com/v1/concepts/by-code/ICD10CM/I10" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/concepts/by-code/ICD10CM/I10",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
icd_concept = response.json()
Response Fields
boolean
Whether the lookup succeeded.
object
Matching concept record.
integer
OMOP concept identifier.
string
Primary concept name.
string
Matched source code.
string
Matched vocabulary.
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
Synonym names, present when
include_synonyms=true.object
Parent and child relationships, present when
include_relationships=true.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-01T00:00:00.000Z",
"valid_end_date": "2099-12-31T00:00:00.000Z",
"invalid_reason": null,
"is_valid": true,
"is_standard": true,
"is_classification": false
},
"meta": {
"request_id": "req_concept_code_123",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2"
}
}
{
"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-01T00:00:00.000Z",
"valid_end_date": "2099-12-31T00:00:00.000Z",
"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_code_123",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2"
}
}
Query Parameters
string
Specific vocabulary release to use (e.g., “2025.2”). Uses latest if not
specified.
boolean
default:"false"
Include concept synonyms in the response
boolean
default:"false"
Include concept relationships and mappings
boolean
default:"false"
Include concept hierarchy information
boolean
default:"true"
Include concepts with invalid_reason set (deprecated/updated concepts). Set to
false to only return valid concepts.
Common Use Cases
1. Source Data Processing
Convert source system codes to standardized concepts during ETL processes.2. Legacy System Integration
Map existing codes from legacy healthcare systems.3. Claims Processing
Look up diagnosis and procedure codes from insurance claims.4. Clinical Documentation
Validate codes entered by healthcare providers.Was this page helpful?