NAV Navbar
Logo cerner
ruby shell

Transition of Care

Retrieves Transition of Care Information

Example Request

require 'httparty'

HTTParty.post(
    'https://cernerdemo.programs.healtheintent.com/api/populations/0a9cc467-094c-403a-84d0-35604e1e418c/toc',
    headers: { 'Content-Type' => 'application/json', 'Authorization' => 'Auth Header' },
    body: {empi_ids: ['0655eafe-a71e-3b55-8258-2a51f43b14fc', '00e4fd48-efe7-301c-89bb-5f6d77312373']}.to_json
)
curl -H 'Authorization: <auth_header>' -H 'Content-Type: application/json' -X POST -d '{"empi_ids":["0655eafe-a71e-3b55-8258-2a51f43b14fc","00e4fd48-efe7-301c-89bb-5f6d77312373"]}' https://cernerdemo.programs.healtheintent.com/api/populations/0a9cc467-094c-403a-84d0-35604e1e418c/toc

Example Response

{
   "toc":[
      {
         "empi_id":"emp-id-1",
         "recommended_toc_location":"Home w/Home Health",
         "readmission_risk_reduction":"",
         "supporting_facts":[  
            {
               "name":"antibiotics",
               "type":"medications",
               "value":"yes"
            }
            {
               "name":"intravenous_medication",
               "type":"medications",
               "value":"yes"
            },
            {
               "name":"snf_admit_source",
               "type":"utility",
               "value":"no"
            },
            {
               "name":"toileting_ability_current",
               "type":"discharge_metrics",
               "value":"INTERPRETATION_OF_ABILITY_DEPENDENT_QUAL"
            },
            {
               "name":"toileting_ability_previous",
               "type":"discharge_metrics",
               "value":"INTERPRETATION_OF_ABILITY_ASSISTED_QUAL"
            },
            {
               "name":"walking_ability_current",
               "type":"discharge_metrics",
               "value":"INTERPRETATION_OF_ABILITY_DEPENDENT_QUAL"
            },
            {
               "name":"walking_ability_previous",
               "type":"discharge_metrics",
               "value":"INTERPRETATION_OF_ABILITY_ASSISTED_QUAL"
            }
         ]
      }
   ]
}

POST https://{client}.programs.healtheintent.com/api/populations/{population_id}/toc

Retrieves transition of care information associated with a patient.

Path Parameters

Parameter Description
population_id The HealtheIntent population ID.

Request Message Body

A JSON array of person IDs.

Name Type Description
empi_ids array: string Contains the IDs of patients within the HealtheIntent population.

Responses

Status Type Description
200 TransitionOfCareInformation Collection of Transition of Care Details and Supporting Facts
400 string Bad Request
401 string Unauthorized
403 string Forbidden
404 string Not Found
500 string Internal Server Error

TransitionOfCareInformation

Name Type Description
empi_id string The ID of the person within the HealtheIntent population.
recommended_toc_location string The location recommended for transition or discharge of patient.
readmission_risk_reduction string The percentage of the amount of risk changed if the patient is discharged to the recommended location. Note: This has been deprecated.
supporting_facts array Contains the supporting facts for the Transition of Care information. See TOCSupportingFact for more details.

TOCSupportingFact

Name Type Description
name string The name of the Supporting Fact. See TOCSupportingFactReference for more details.
value string The actual value to the corresponding Supporting Fact. See TOCSupportingFactReference for more details.
type string The type or category to which the Supporting Facts belongs. See TOCSupportingFactReference for more details.

TOCSupportingFactReference

The table below provides details about each supporting fact of Transition of Care.

Name Description Value Interpretation Example TOCSupportingFact object
antibiotics Antibiotics medications or ingredients that were started after the start of the encounter. Possible values of ‘yes’ or ‘no’ {"name": "antibiotics","type": "medications","value": "yes"}
intravenous_medication Intravenous medications that were started after the start of the encounter. Possible values of ‘yes’ or ‘no’ {"name": "intravenous_medications","type": "medications","value": "yes"}
toileting_ability_current Indicates a clinical finding of toileting ability after the start of this encounter. Examples: ‘INTERPRETATION_OF_ABILITY_DEPENDENT_QUAL’ or ‘INTERPRETATION_OF_ABILITY_ASSISTED_QUAL’ {"name": "toileting_ability_current","type": "discharge_metrics","value": "INTERPRETATION_OF_ABILITY_ASSISTED_QUAL "}
toileting_ability_previous Indicates a clinical finding of toileting ability before the start of this encounter, but within the past year. Examples: ‘INTERPRETATION_OF_ABILITY_DEPENDENT_QUAL’ or ‘INTERPRETATION_OF_ABILITY_ASSISTED_QUAL’ {"name": "toileting_ability_previous","type": "discharge_metrics","value": "INTERPRETATION_OF_ABILITY_ASSISTED_QUAL "}
walk_ability_current Indicates a clinical finding of walking ability after the start of this encounter. Examples: ‘INTERPRETATION_OF_ABILITY_DEPENDENT_QUAL’ or ‘INTERPRETATION_OF_ABILITY_ASSISTED_QUAL’ {"name": "walk_ability_current","type": "discharge_metrics","value": "INTERPRETATION_OF_ABILITY_ASSISTED_QUAL "}
walk_ability_previous Indicates a clinical finding of walking ability before the start of this encounter, but within the past year. Examples: ‘INTERPRETATION_OF_ABILITY_DEPENDENT_QUAL’ or ‘INTERPRETATION_OF_ABILITY_ASSISTED_QUAL’ {"name": "walk_ability_previous","type": "discharge_metrics","value": "INTERPRETATION_OF_ABILITY_ASSISTED_QUAL "}
snf_admit_source The qualifying encounter that has an with admit source of “TRANSFER_FROM_SNF”. Possible values of ‘yes’ or ‘no’ {"name": "snf_admit_source","type": "utility","value": "yes"}