The Classify Terminology API takes an input coding and provides a set of classifications based on the domain. For example, a medication code may be classified by its ingredient(s) and strength, while a condition is classified by category and whether it is acute or chronic.
Contents
Each domain has its own classify operation, but they all work in a similar manner. In the body parameters of the request, you provide the code and system for the input coding. You may optionally provide a display value. For example:
{
"code": "861004",
"system": "RxNorm"
}
Rosetta will then classify the input coding into a set of domain-specific classifications.
{
"medRtTherapeuticClass": [
"Blood Glucose Regulators"
],
"rxNormIngredient": [
"metformin"
],
"rxNormStrength": "1000MG",
"rxNormGeneric": true,
"immunization": false,
"covid19Rx": null
}
The classifications in the response data are represented as a set of key/value pairs. The values can take several forms, depending on the domain:
If a particular classification was not found for the given input, the value for that key will be null
.
The following classify operations are available:
Operation | Input Reference Code Systems |
---|---|
Condition
Provides clinical categories, acute vs. chronic, risk adjustment categories, and COVID status. |
|
Medication
Provides RxNorm properties, MEDRT therapeutic class, and COVID-related category (including vaccination). |
|
Observation
Provides LOINC properties and COVID test type. |
|
Alternatively, you can use the $classify operation which is a superset of the individual domain-specific classify operations.