NAV Navbar
Logo cerner
Ruby Shell

Risk Assessment API v1

HealtheIntent Service exposing operations to work with Risk assessment.

URL: https://cernerdemo.api.us.healtheintent.com/risk-assessment/v1

Risk Assessment

A risk assessment represents the quantified likelihood of certain outcomes for a patient, for example, the risk of potentially preventable encounters (PPEs) or the likelihood that a patient might suffer from cardiac arrest. In addition to to the type, a risk assessment includes attributes that indicate the method used to inform the assessment and the condition if the assessment pertains to one.

Get a List of Risk Assessments for a Patient

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.get('https://cernerdemo.api.us.healtheintent.com/risk-assessment/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/106824bb-a35c-4870-97fa-145c7079bc2a/risk-assessments', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us.healtheintent.com/risk-assessment/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/106824bb-a35c-4870-97fa-145c7079bc2a/risk-assessments \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "2fb52376-cadd-3a98-8181-61cb77fdc3a3",
      "patient": {
        "id": "dd2cc519-caf5-4857-9f07-b12741bb5f92",
        "populationId": "1424e81d-8cea-4d6b-b140-d6630b684a58"
      },
      "type": {
        "codings": [
          {
            "code": "161168008",
            "display": "Morbidity Prediction",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "sourceCodings": [
          {
            "code": "161168008",
            "display": "Morbidity Prediction",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "text": "Morbidity Prediction"
      },
      "method": {
        "codings": [
          {
            "code": "713678009",
            "display": "Congestive heart failure, hypertension, age 75 years or older, diabetes, previous stroke or transient ischemic attack, vascular disease, age 65-74 years, and sex category risk score",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "sourceCodings": [
          {
            "code": "713678009",
            "display": "Congestive heart failure, hypertension, age 75 years or older, diabetes, previous stroke or transient ischemic attack, vascular disease, age 65-74 years, and sex category risk score",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "text": "Congestive heart failure, hypertension, age 75 years or older, diabetes, previous stroke or transient ischemic attack, vascular disease, age 65-74 years, and sex category risk score"
      },
      "condition": {
        "codings": [
          {
            "code": "230690007",
            "display": "Stroke",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "sourceCodings": [
          {
            "code": "230690007",
            "display": "Stroke",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "text": "Stroke"
      },
      "value": {
        "numeric": "2"
      },
      "assessedAt": "2018-07-18T17:10:00.000Z"
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us.healtheintent.com/risk-assessment/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/106824bb-a35c-4870-97fa-145c7079bc2a/risk-assessments?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us.healtheintent.com/risk-assessment/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/106824bb-a35c-4870-97fa-145c7079bc2a/risk-assessments?offset=0&limit=20"
}

GET /populations/{populationId}/patients/{patientId}/risk-assessments

Retrieves a list of risk assessments for the specified patient identifier.

Parameters

Parameter In Type Required Default Description Accepted Values
populationId path string true N/A The identifier of the population. -
patientId path string true N/A The identifier of the patient within the population. -
type query string false N/A The type system and type code used for filtering risk assessments. Must be in the format {typeSystem}|{typeCode}. Filtering applies to both codings and source codings. -
offset query integer(int32) false N/A Indicates the starting index of the paginated collection. -
limit query integer(int32) false 20 Indicates the number of results returned in a single page. The value set must be between 1 and 100. -

Response Statuses

Status Meaning Description Schema
200 OK OK RiskAssessments
400 Bad Request Bad request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Resource not found Error

Get a Single Risk Assessment

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.get('https://cernerdemo.api.us.healtheintent.com/risk-assessment/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/risk-assessments/2fb52376-cadd-3a98-8181-61cb77fdc3a3', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us.healtheintent.com/risk-assessment/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/risk-assessments/2fb52376-cadd-3a98-8181-61cb77fdc3a3 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "2fb52376-cadd-3a98-8181-61cb77fdc3a3",
  "patient": {
    "id": "dd2cc519-caf5-4857-9f07-b12741bb5f92",
    "populationId": "1424e81d-8cea-4d6b-b140-d6630b684a58"
  },
  "type": {
    "codings": [
      {
        "code": "161168008",
        "display": "Morbidity Prediction",
        "system": "2.16.840.1.113883.6.96"
      }
    ],
    "sourceCodings": [
      {
        "code": "161168008",
        "display": "Morbidity Prediction",
        "system": "2.16.840.1.113883.6.96"
      }
    ],
    "text": "Morbidity Prediction"
  },
  "method": {
    "codings": [
      {
        "code": "713678009",
        "display": "Congestive heart failure, hypertension, age 75 years or older, diabetes, previous stroke or transient ischemic attack, vascular disease, age 65-74 years, and sex category risk score",
        "system": "2.16.840.1.113883.6.96"
      }
    ],
    "sourceCodings": [
      {
        "code": "713678009",
        "display": "Congestive heart failure, hypertension, age 75 years or older, diabetes, previous stroke or transient ischemic attack, vascular disease, age 65-74 years, and sex category risk score",
        "system": "2.16.840.1.113883.6.96"
      }
    ],
    "text": "Congestive heart failure, hypertension, age 75 years or older, diabetes, previous stroke or transient ischemic attack, vascular disease, age 65-74 years, and sex category risk score"
  },
  "condition": {
    "codings": [
      {
        "code": "230690007",
        "display": "Stroke",
        "system": "2.16.840.1.113883.6.96"
      }
    ],
    "sourceCodings": [
      {
        "code": "230690007",
        "display": "Stroke",
        "system": "2.16.840.1.113883.6.96"
      }
    ],
    "text": "Stroke"
  },
  "value": {
    "numeric": "2"
  },
  "assessedAt": "2018-07-18T17:10:00.000Z"
}

GET /populations/{populationId}/risk-assessments/{riskAssessmentId}

Retrieves a single risk assessment.

Parameters

Parameter In Type Required Default Description Accepted Values
populationId path string true N/A The identifier of the population. -
riskAssessmentId path string true N/A The unique identifier for the risk assessment. -

Response Statuses

Status Meaning Description Schema
200 OK OK RiskAssessment
400 Bad Request Bad request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Resource not found Error

Get a List of Risk Assessments

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.get('https://cernerdemo.api.us.healtheintent.com/risk-assessment/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/risk-assessments', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us.healtheintent.com/risk-assessment/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/risk-assessments \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "2fb52376-cadd-3a98-8181-61cb77fdc3a3",
      "patient": {
        "id": "dd2cc519-caf5-4857-9f07-b12741bb5f92",
        "populationId": "1424e81d-8cea-4d6b-b140-d6630b684a58"
      },
      "type": {
        "codings": [
          {
            "code": "161168008",
            "display": "Morbidity Prediction",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "sourceCodings": [
          {
            "code": "161168008",
            "display": "Morbidity Prediction",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "text": "Morbidity Prediction"
      },
      "method": {
        "codings": [
          {
            "code": "713678009",
            "display": "Congestive heart failure, hypertension, age 75 years or older, diabetes, previous stroke or transient ischemic attack, vascular disease, age 65-74 years, and sex category risk score",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "sourceCodings": [
          {
            "code": "713678009",
            "display": "Congestive heart failure, hypertension, age 75 years or older, diabetes, previous stroke or transient ischemic attack, vascular disease, age 65-74 years, and sex category risk score",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "text": "Congestive heart failure, hypertension, age 75 years or older, diabetes, previous stroke or transient ischemic attack, vascular disease, age 65-74 years, and sex category risk score"
      },
      "condition": {
        "codings": [
          {
            "code": "230690007",
            "display": "Stroke",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "sourceCodings": [
          {
            "code": "230690007",
            "display": "Stroke",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "text": "Stroke"
      },
      "value": {
        "numeric": "2"
      },
      "assessedAt": "2018-07-18T17:10:00.000Z"
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us.healtheintent.com/risk-assessment/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/risk-assessments?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us.healtheintent.com/risk-assessment/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/risk-assessments?offset=0&limit=20"
}

GET /populations/{populationId}/risk-assessments

Retrieves a list of risk assessments.

Parameters

Parameter In Type Required Default Description Accepted Values
populationId path string true N/A The identifier of the population. -
patientId query array[string] false N/A Filters by a list of patients that risk assessments are associated with, up to a limit of 20 patients. -
type query string false N/A The type system and type code used for filtering risk assessments. Must be in the format {typeSystem}|{typeCode}. Filtering applies to both codings and source codings. -
offset query integer(int32) false N/A Indicates the starting index of the paginated collection. -
limit query integer(int32) false 20 Indicates the number of results returned in a single page. The value set must be between 1 and 100. -

Response Statuses

Status Meaning Description Schema
200 OK OK RiskAssessments
400 Bad Request Bad request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Resource not found Error

Schema Definitions

RiskAssessments

Name Type Required Description Accepted Values
items [RiskAssessment] true No description -
totalResults integer(int32) false The total number of results for the specified parameters. -
firstLink string true The first page of results. -
lastLink string false The last page of results. -
prevLink string false The previous page of results. -
nextLink string false The next page of results. -

RiskAssessment

Name Type Required Description Accepted Values
id string true An ID that uniquely identifies the risk assessment. -
patient PatientReference true No description -
type CodeableConcept true No description -
method CodeableConcept false No description -
condition CodeableConcept false No description -
value Value false No description -
assessedAt string true The date or date and time when the risk score was created or recorded, in ISO 8601 formatting with precision ranging from YYYY to YYYY-MM-DDThh:mm:ss.SSSZ. -

PatientReference

Name Type Required Description Accepted Values
id string false The identifier of the patient within the population. -
populationId string false The identifier of the population for the patient. -

CodeableConcept

Name Type Required Description Accepted Values
codings [Code] false A list of codified values from standard code systems recognized by HealtheIntent. -
sourceCodings [Code] false The list of codified values provided in the source data. Not all of these codes are available in the codings list. For example, local or proprietary codes are not included on the codings list because they are not recognized by HealtheIntent. -
text string false This may be a localized or annotated description of the element provided by a source system or display text associated with one of the codes on the codings or sourceCodings list. -

Code

Name Type Required Description Accepted Values
code string false The unique identifier of the code. -
display string false A human-readable representation of the code. -
system string false The identifier of the coding system that gives meaning to the code. -

Value

Name Type Required Description Accepted Values
numeric string true The raw risk score expressed as a decimal. -

Error

Name Type Required Description Accepted Values
code integer(int32) true Http response status code representing the error. -
message string true Human readable description of the error. -
errorDetails [ErrorDetail] false List of additional error details. -

ErrorDetail

Name Type Required Description Accepted Values
domain string false A subsystem or context where an error occurred. -
reason string false Codified value representing the specific error resulting in the current error status. -
message string false Human readable description of an error. -
locationType string false Location or type of the field that caused an error. query, header, path, formData, body
location string false Name of the field that caused an error. -