Skip to main content

​
Overview

Tests whether concept A subsumes (is an ancestor of) concept B, or vice versa. Used for hierarchy-aware code validation and clinical decision support. Supports both type-level and instance-level invocation.

​
Request

# Does "Diabetes mellitus" subsume "Type 2 diabetes mellitus"?
curl "https://fhir.omophub.com/fhir/r4/CodeSystem/\$subsumes?\
codeA=73211009&codeB=44054006&system=http://snomed.info/sct" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
By OMOP concept ID

curl "https://fhir.omophub.com/fhir/r4/CodeSystem/\$subsumes?\
codeA=201820&codeB=201826&system=https://fhir-terminology.ohdsi.org" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Instance-level

curl "https://fhir.omophub.com/fhir/r4/CodeSystem/omop-v20260227/\$subsumes?\
codeA=201820&codeB=201826" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Parameters

ParameterTypeRequiredDescription
codeAcodeYesFirst concept code
codeBcodeYesSecond concept code
systemuriYes (type-level)Code system URI

​
Response

{
  "resourceType": "Parameters",
  "parameter": [
    { "name": "outcome", "valueCode": "subsumes" }
  ]
}

​
Possible Outcomes

OutcomeMeaning
equivalentA and B are the same concept
subsumesA is an ancestor of B (A subsumes B)
subsumed-byA is a descendant of B (B subsumes A)
not-subsumedNo hierarchical relationship between A and B

​
Examples

# A subsumes B (Diabetes mellitus → Type 2 DM)
# → outcome: subsumes

# Reverse (Type 2 DM → Diabetes mellitus)
# → outcome: subsumed-by

# Same concept
# → outcome: equivalent

# Unrelated concepts (Type 2 DM vs Myocardial infarction)
# → outcome: not-subsumed

​
Errors

HTTPIssue CodeCause
400invalidMissing codeA, codeB, or system parameter
403forbiddenRestricted vocabulary (CPT4)
404not-foundCode not found in the specified code system