The Standardize Terminology API takes an input coding and finds matching reference codings from several standard code systems. It can also find codings using plain-text inputs from uncoded data.
Each domain has its own standardize operation, but they all work in a similar manner. In the body parameters of the request, you provide what information you have about the input coding. You must provide either a code or display value (i.e., the plain-text description of the code you’re looking for). You may optionally provide a source code system (if known), and a target code system (to limit results to codes from a specific system).
Based on the domain, Rosetta will search for matching codings from well-known reference code systems. Each domain uses different reference code systems. For example, medication codes may be standardized using codings from RxNorm and NDC, while report types may use LOINC and SNOMED. Consult the details of the individual standardize operations for a complete list of which reference code systems are used for each domain.
For example, you may start with only some free text:
{
"display": "severe asthma"
}
Rosetta will then find matching conditions in the appropriate reference code systems:
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "370221004",
"display": "Severe asthma (disorder)"
},
{
"system": "http://hl7.org/fhir/sid/icd-10-cm",
"code": "J45.50",
"display": "Severe persistent asthma, uncomplicated"
}
]
}
You could also start with just a code (e.g., "code": "370221004"
) and find matching conditions for that code (and comparable ones), even if you didn’t know the code system.
system
parameter is optional, but it is suggested that you provide it when possible. Some codes exist in multiple code systems with very different meanings, and providing context for the code you’re looking for helps Rosetta to determine the most appropriate matches.
The following standardize operations are available:
Operation | Reference Code Systems |
---|---|
Condition
Including problems and diagnoses. |
|
Medication
Including immunizations. |
|
Observation
Including labs, radiology, and other observations. |
|
Labs
Including lab observations, panels, and reports |
|
Radiology
Including radiology observations and reports |
|
Procedure
Including services found in claims and clinical data. |
|
Alternatively, you can use the $translate operation which is a superset of the individual domain-specific standardize operations.
The following fields are common to all standardize operations.
Code value. Either code or display is required.
Display string. Either code or display is required.
The source code system (as a name or URL).
The desired code system (as a name or URL).
List of matching code values.
Code value.
The source code system (as a URL).
Display string.