NAV Navbar
Logo cerner
Ruby Shell

Diagnosis Insights Application API v1

The HealtheIntent Diagnosis Insights application API enables you to configure and monitor the Diagnosis Insights application and related components.

URL: https://cernerdemo.api.us-1.healtheintent.com/diagnosis-insights-application/v1

Condition Actions

Condition actions are the actions that a user can take on a patient’s conditions as part of a *HealtheIntent* condition identification workflow. For example, adding an encounter diagnosis to a condition, adding a diagnosis to a patient’s problem list, dismissing a patient’s condition, and so on.

Retrieve a Single Condition Action

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-1.healtheintent.com/diagnosis-insights-application/v1/pipelines/61ea6fe1-6d57-4637-ac7e-72acc5d2390e/patients/8c075cb6-2bd0-4a6b-b3ba-abfbf3660044/condition-actions/3fa85f64-5717-4562-b3fc-2c963f66afa6', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/diagnosis-insights-application/v1/pipelines/61ea6fe1-6d57-4637-ac7e-72acc5d2390e/patients/8c075cb6-2bd0-4a6b-b3ba-abfbf3660044/condition-actions/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /pipelines/{pipelineId}/patients/{patientId}/condition-actions/{conditionActionId}

Retrieves a single condition action performed on the patient’s condition.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The unique ID of the pipeline in which the condition outcomes are performed. -
patientId path string true N/A The unique ID of the patient to retrieve conditions. -
conditionActionId path string true N/A The unique ID of the condition action performed on the patient’s condition. -

Response Statuses

Status Meaning Description Schema
200 OK Single condition action performed on the patient’s condition. ConditionAction
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Create a Condition Action

Example Request:




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

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

result = HTTParty.post('https://cernerdemo.api.us-1.healtheintent.com/diagnosis-insights-application/v1/pipelines/61ea6fe1-6d57-4637-ac7e-72acc5d2390e/patients/8c075cb6-2bd0-4a6b-b3ba-abfbf3660044/condition-actions', headers: headers, body: {"conditionIdentificationDefinition":{"id":"f89fa3dd-57a8-494b-b157-4640ccc081e3"},"type":"ADD_ENCOUNTER_DIAGNOSIS","encounter":{"sourceIdentifier":{"dataPartitionId":"e5f34c23-e572-44c3-a2cd-7ca358dcec9f","id":"d5f34c23-e572-44c3-a2cd-7ca358dcec9a"}},"condition":{"sourceIdentifier":{"dataPartitionId":"e5f34c23-e572-44c3-a2cd-7ca358dcec9f","id":"d5f34c23-e572-44c3-a2cd-7ca358dcec9a"},"codes":[{"code":"T86.40","display":"Amputation","system":"2.16.8404.1.113883.6.96"}]},"performedBy":{"id":"f89fa3dd-57a8-494b-b157-4640ccc081e3"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/diagnosis-insights-application/v1/pipelines/61ea6fe1-6d57-4637-ac7e-72acc5d2390e/patients/8c075cb6-2bd0-4a6b-b3ba-abfbf3660044/condition-actions \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"conditionIdentificationDefinition":{"id":"f89fa3dd-57a8-494b-b157-4640ccc081e3"},"type":"ADD_ENCOUNTER_DIAGNOSIS","encounter":{"sourceIdentifier":{"dataPartitionId":"e5f34c23-e572-44c3-a2cd-7ca358dcec9f","id":"d5f34c23-e572-44c3-a2cd-7ca358dcec9a"}},"condition":{"sourceIdentifier":{"dataPartitionId":"e5f34c23-e572-44c3-a2cd-7ca358dcec9f","id":"d5f34c23-e572-44c3-a2cd-7ca358dcec9a"},"codes":[{"code":"T86.40","display":"Amputation","system":"2.16.8404.1.113883.6.96"}]},"performedBy":{"id":"f89fa3dd-57a8-494b-b157-4640ccc081e3"}}

POST /pipelines/{pipelineId}/patients/{patientId}/condition-actions

Creates a condition action that can be performed on the patient’s condition.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The unique ID of the pipeline in which the condition outcomes are performed. -
patientId path string true N/A The unique ID of the patient to retrieve conditions. -
body body postPipelinesPipelineidPatientsPatientidConditionActions true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created A condition action object ConditionAction
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error

Response Headers

Status Header Type Format Description
201 Location string The URL of the created condition action.

Retrieve a List of Condition Actions

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-1.healtheintent.com/diagnosis-insights-application/v1/pipelines/61ea6fe1-6d57-4637-ac7e-72acc5d2390e/patients/8c075cb6-2bd0-4a6b-b3ba-abfbf3660044/condition-actions', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/diagnosis-insights-application/v1/pipelines/61ea6fe1-6d57-4637-ac7e-72acc5d2390e/patients/8c075cb6-2bd0-4a6b-b3ba-abfbf3660044/condition-actions \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /pipelines/{pipelineId}/patients/{patientId}/condition-actions

Retrieves a paginated list of condition actions performed on the patient.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The unique ID of the pipeline in which the condition outcomes are performed. -
patientId path string true N/A The unique ID of the patient to retrieve conditions. -
type query array[string] false N/A The type of the actions performed on the condition. This query parameter can be -
conditionIdentificationDefinitionId query array[string] false N/A The unique ID of the condition identification definition ID on which the condition -
id query array[string] false N/A The unique ID of the condition action. This query parameter can be repeated multiple -
offset query integer(int32) false 0 The number of results to skip from the beginning of the list of results (typically for the purpose of paging). The minimum offset is 0. There is no maximum offset. -
limit query integer(int32) false 20 The maximum number of results to display per page. The minimum limit is 1. The maximum limit is 100. -
orderBy query string false type A comma-separated list of fields by which to sort. type, -type, performedAt, -performedAt

Response Statuses

Status Meaning Description Schema
200 OK A collection of condition action objects ConditionActions
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error

Schema Definitions

ConditionAction

Name Type Required Description Accepted Values
id string true The ID of the condition action. -
pipeline PipelineReference true The ID of the pipeline. -
patient PatientReference true The ID of the patient. -
encounter Encounter false The encounter that this condition belongs to. -
conditionIdentificationDefinition ConditionIdentificationDefinition true The condition identification definition that this condition belongs to. -
type string true The type of the action performed on this patient’s condition. ADD_ENCOUNTER_DIAGNOSIS, ADD_DISMISS_CONDITION, DELETE_DISMISS_CONDITION, ADD_REJECT_CONDITION, DELETE_REJECT_CONDITION
condition Condition false The condition details of the source system. -
performedAt string true The date and time when the condition action was initially entered into the system. In ISO 8601 formatting with precision to YYYY-MM-DDThh:mm:ss.SSSZ, such as 2018-02-13T20:41:18.181Z. The time is set automatically when the condition action is first created. Therefore, the field does not need to be set explicitly. -
performedBy PersonnelReference true The personnel who performed the condition action. -

PipelineReference

Name Type Required Description Accepted Values
id string true The ID of the pipeline. -

PatientReference

Name Type Required Description Accepted Values
id string true The ID of the patient within the population. -

Encounter

Name Type Required Description Accepted Values
sourceIdentifier SourceIdentifier true The source identifier information for the encounter. -

SourceIdentifier

Name Type Required Description Accepted Values
dataPartitionId string true The ID of the data partition. See the Data Partitions endpoint of the Data Source API for more information. -
id string true An ID that uniquely identifies this entity for a patient in the data partition. -

ConditionIdentificationDefinition

Name Type Required Description Accepted Values
id string true The unique ID of the condition identification definition. -
name string false The name of the condition identification definition. -
type string true The type of the condition identification definition. PRIOR, SUSPECTED, CLARIFICATION

Condition

Name Type Required Description Accepted Values
sourceIdentifier SourceIdentifier true The source identifier information for the condition. -
codes [Code] false Identifies the condition and its categories using a textual description or codified values. -

Code

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

PersonnelReference

Name Type Required Description Accepted Values
id string true The ID of the personnel in the tenant. -

Error

Name Type Required Description Accepted Values
code integer(int32) true The HTTP response status code that represents the error. -
message string true A human-readable description of the error. -
errorDetails [ErrorDetail] false A 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 A codified value that represents the specific error that caused the current error status. -
message string false A human-readable description of an error. -
locationType string false The location or type of the field that caused an error. query, header, path, formData, body
location string false The name of the field that caused an error. -

postPipelinesPipelineidPatientsPatientidConditionActions

Name Type Required Description Accepted Values
conditionIdentificationDefinition object true The condition identification definition that this condition belongs to. -
» id string true The unique ID of the condition identification definition. -
type string true The type of the action performed on this patient’s condition. ADD_ENCOUNTER_DIAGNOSIS, ADD_DISMISS_CONDITION, DELETE_DISMISS_CONDITION, ADD_REJECT_CONDITION, DELETE_REJECT_CONDITION
encounter object false The encounter associated with the condition. -
» sourceIdentifier object true The source identifier information. -
»» dataPartitionId string true The ID of the data partition. See the Data Partitions endpoint of the Data Source API for more information. -
»» id string true An ID that uniquely identifies this entity for a patient in the data partition. -
condition object false The condition details of the source system. -
» sourceIdentifier object true The source identifier information. -
»» dataPartitionId string true The ID of the data partition. See the Data Partitions endpoint of the Data Source API for more information.‘ -
»» id string true An ID that uniquely identifies this entity for a patient in the data partition. -
» codes [object] false List of condition codes associated with the condition. -
»» code string true The unique ID of the code. -
»» display string false A human-readable representation of the code. -
»» system string true The ID of the coding system that gives meaning to the code. -
performedBy object true The personnel who performed the condition action. -
» id string true The unique ID of the personnel who performed the condition action. -

ConditionActions

Name Type Required Description Accepted Values
items [ConditionAction] true An array containing the current page of results. -
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. -