Categorize
In this tutorial, we will employ the Categorize API to organize the problem list into clinical categories. The API can optionally apply a specialty sort, prioritizing the category most relevant to the given provider to the top of the list.
This capability is licensed under IMO Core.
What problem can you address with this API?
Problem lists can house a large amount of information covering multiple body systems and specialties. The task of sorting through multiple/complex diagnoses can be taxing and time-consuming when preparing for an encounter. That’s why the Categorize API organizes the problem list into distinct clinical categories and specialties.
The API organizes the patient problem list, giving providers better focus and preparation time.
Setup
Start with a problem list that you will arrange with the Categorize capability.
List example:
Problem List
Authentication
To call the Categorize endpoint, use the access token obtained from our OAuth2 authorization server.
How to call the Categorize API
This request will organize the problem list into distinct clinical categories.
- Simple Categorize
Description: Categorize the problem list by clinical category.
Note: The request set in this example is condensed to only show liver cancer and not the full problem list.
Request:
| curl --location --request POST 'https://api-sandbox.imohealth.com/problemlistmanagement/problems/catego…' \ --header 'Authorization: {{UPDATE_BEARER_TOKEN_HERE}}' \ --header 'Content-Type: application/json' \ --data '{ "problems": [ { "title": "Liver cancer, primary, with metastasis from liver to other site" } ] }' |
Response:
|
{
"categories": [
{
"code": "1040459352",
"title": "Hematology and Neoplasia",
"problems": [
{
"title": "Liver cancer, primary, with metastasis from liver to other site",
"lexical_code": "802930",
"lexical_title": "Liver cancer, primary, with metastasis from liver to other site",
"icd10cm": [
{
"code": "C22.8",
"title": "Malignant neoplasm of liver, primary, unspecified as to type"
}
],
"icd9cm": [
{
"code": "155.0",
"title": "Malignant neoplasm of liver, primary"
}
],
"snomed": [
{
"code": "95214007",
"title": "Primary malignant neoplasm of liver"
}
],
"details": {
"cluster_code": "1741446159",
"cluster_title": "HN: GI neoplasia Cluster",
"hcc_category_code": "9",
"hcc_category_code_next": "20",
"specialty_codes": [
"2415",
"2419"
]
}
}
]
}
]
}
|
Summary: Simple categorize
- You sent a call to the Categorize API with a goal to organize the unrefined problem list.
- The API organized the list of health problems into clinical categories.
- You can now view the problem list as conditions listed under their clinical categories.
- For example: “liver cancer” has been categorized under the “oncology” category.
- Specialty Categorize
Description: Categorize the problem list by provider specialty.
Request:
| curl --location --request POST 'https://api-sandbox.imohealth.com/problemlistmanagement/problems/catego…' \ --header 'Authorization: {{UPDATE_BEARER_TOKEN_HERE}}' \ --header 'Content-Type: application/json' \ --data '{ "priority_specialty": "Pulmonary", "problems": [ { "title": "Heart attack" }, { "title": "CAD (coronary artery disease), native coronary artery" }, { "title": "Essential hypertension" }, { "title": "Breathing Difficulties" } ] }' |
Response:
|
{
"categories": [
{
"code": "2423",
"title": "Pulmonary",
"problems": [
{
"title": "Breathing Difficulties",
"lexical_code": "42466",
"lexical_title": "Difficulty breathing",
"icd10cm": [
{
"code": "R06.89",
"title": "Other abnormalities of breathing"
}
],
"icd9cm": [
{
"code": "786.09",
"title": "Other dyspnea and respiratory abnormality"
}
],
"snomed": [
{
"code": "230145002",
"title": "Difficulty breathing"
}
],
"details": {
"cluster_code": "1035677151",
"cluster_title": "PU: Lower respiratory Cluster",
"hcc_category_code": "0",
"hcc_category_code_next": "0",
"specialty_codes": [
"2423",
"2428",
"2770857527",
"2770886103"
]
}
}
]
},
{
"code": "1068676071",
"title": "Cardiac and Vasculature",
"problems": [
{
"title": "Essential hypertension",
"lexical_code": "30422",
"lexical_title": "Essential hypertension",
"icd10cm": [
{
"code": "I10",
"title": "Essential (primary) hypertension"
}
],
"icd9cm": [
{
"code": "401.9",
"title": "Unspecified essential hypertension"
}
],
"snomed": [
{
"code": "59621000",
"title": "Essential hypertension"
}
],
"details": {
"cluster_code": "1424614087",
"cluster_title": "CV: Hypertension Cluster",
"hcc_category_code": "0",
"hcc_category_code_next": "0",
"specialty_codes": [
"2411",
"2412",
"2428",
"2770857527",
"2771316791",
"2780914991"
]
}
},
{
"title": "CAD (coronary artery disease), native coronary artery",
"lexical_code": "514373",
"lexical_title": "CAD (coronary artery disease), native coronary artery",
"icd10cm": [
{
"code": "I25.10",
"title": "Atherosclerotic heart disease of native coronary artery without angina pectoris"
}
],
"icd9cm": [
{
"code": "414.01",
"title": "Coronary atherosclerosis of native coronary artery"
}
],
"snomed": [
{
"code": "53741008",
"title": "Coronary arteriosclerosis"
}
],
"details": {
"cluster_code": "1035677191",
"cluster_title": "CV: Coronary artery Cluster",
"hcc_category_code": "0",
"hcc_category_code_next": "0",
"specialty_codes": [
"2411",
"2428",
"2770857527"
]
}
},
{
"title": "Heart attack",
"lexical_code": "50263",
"lexical_title": "Heart attack",
"icd10cm": [
{
"code": "I21.9",
"title": "Acute myocardial infarction, unspecified"
}
],
"icd9cm": [
{
"code": "410.90",
"title": "Acute myocardial infarction, unspecified site, episode of care unspecified"
}
],
"snomed": [
{
"code": "22298006",
"title": "Myocardial infarction"
}
],
"details": {
"cluster_code": "1035677191",
"cluster_title": "CV: Coronary artery Cluster",
"hcc_category_code": "86",
"hcc_category_code_next": "228",
"specialty_codes": [
"2411",
"2428",
"2770857527"
]
}
}
]
}
]
}
|
Summary: Specialty categorize
- You sent a call to the Categorize API with a goal to sort the list further, with the given provider’s specialty displayed at the top of the list.
- The API handled the request by refining the problem list into a view that prioritizes the provider’s specialty.
- You can now view the problem list with a focus on the provider’s specialty (e.g., pulmonology).
