NAV Navbar
Logo cerner
Ruby Shell

Condition Identification API v1

The HealtheIntent Condition Identification API identifies condition scenarios that are useful to a provider when considering what diagnoses are currently appropriate for a patient.

Note: The data retrieved by this API is filtered based on your sensitive data filters for HealtheIntent. Ensure that your implementations of this API are designed with this in mind, and if you integrate data from HealtheIntent into a clinical workflow using this API, ensure that your users are informed of your sensitive data filters. See Understand Sensitive Data in HealtheIntent in the Reference Pages on Cerner Wiki for more information.

URL: https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1

Definitions

The condition identification definitions represent the content of each condition identification, including the name, description, cohort, algorithm components, and other related information.

Create a Definition

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/condition-identification/v1/definitions', headers: headers, body: {"name":"Prior Dx: Chronic Skin Ulcer","description":"HCC V22-M-161 Chronic Ulcer of Skin, Except Pressure (CLAIM)","messages":{"text":"Patient has been reported as having \"hypertensive heart and chronic kidney disease with heart failure,\" but no corresponding heart failure code has been submitted."},"catalog":"HealthecareCompany","type":"PRIOR","cohort":{"id":"4ee16093-bcb5-4ecd-b200-9bef190545cc"},"tags":[{"key":"INCLUDE_IN_CCFI_REPORT","value":"True"}],"aliases":[{"system":"HEALTHCARECOMPANY","value":"404"}],"components":[{"mnemonic":"ChronicSkinUlcerPrior1Yr","category":"PAST_PERIOD"}],"createdBy":{"id":"c5693417-38ad-408d-a438-3581f416e512"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/definitions \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Prior Dx: Chronic Skin Ulcer","description":"HCC V22-M-161 Chronic Ulcer of Skin, Except Pressure (CLAIM)","messages":{"text":"Patient has been reported as having \"hypertensive heart and chronic kidney disease with heart failure,\" but no corresponding heart failure code has been submitted."},"catalog":"HealthecareCompany","type":"PRIOR","cohort":{"id":"4ee16093-bcb5-4ecd-b200-9bef190545cc"},"tags":[{"key":"INCLUDE_IN_CCFI_REPORT","value":"True"}],"aliases":[{"system":"HEALTHCARECOMPANY","value":"404"}],"components":[{"mnemonic":"ChronicSkinUlcerPrior1Yr","category":"PAST_PERIOD"}],"createdBy":{"id":"c5693417-38ad-408d-a438-3581f416e512"}}

POST /definitions

Creates a definition.

Parameters

Parameter In Type Required Default Description Accepted Values
body body postDefinitions true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created A definition object Definition
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 definition.

Retrieve a List of Definitions

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/condition-identification/v1/definitions', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/definitions \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /definitions

Retrieves a list of definitions.

Parameters

Parameter In Type Required Default Description Accepted Values
id query array[string] false N/A The ID of the definition. This query parameter can be repeated multiple times to query for multiple definitions at a time. -
name query string false N/A The name or partial name of the definition. -
aliasSystem query string false N/A The assigning authority responsible for assigning the condition identification definition\ -
aliasValue query string false N/A The value or ID of the condition identification definition in the context of\ -
tag query array[string] false N/A The colon-delimited combination of the key and value of a tag (for example, Use:Production). -
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 name,updatedAt A comma-separated list of fields by which to sort. name, -name, updatedAt, -updatedAt

Response Statuses

Status Meaning Description Schema
200 OK A collection of definition objects Definitions
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error

Delete a Definition

Example Request:


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

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

result = HTTParty.delete('https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/definitions/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/definitions/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /definitions/{definitionId}

Deletes a definition.

Parameters

Parameter In Type Required Default Description Accepted Values
definitionId path string true N/A The unique ID of the definition. -

Response Statuses

Status Meaning Description Schema
204 No Content No content None
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Update a Definition

Example Request:




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

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

result = HTTParty.put('https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/definitions/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers, body: {"name":"Prior Dx: Chronic Skin Ulcer","description":"HCC V22-M-161 Chronic Ulcer of Skin, Except Pressure (CLAIM)","messages":{"text":"Patient has been reported as having \"hypertensive heart and chronic kidney disease with heart failure,\" but no corresponding heart failure code has been submitted."},"catalog":"HealthecareCompany","type":"PRIOR","cohort":{"id":"4ee16093-bcb5-4ecd-b200-9bef190545cc"},"tags":[{"key":"INCLUDE_IN_CCFI_REPORT","value":"True"}],"aliases":[{"system":"HEALTHCARECOMPANY","value":"404"}],"components":[{"mnemonic":"ChronicSkinUlcerPrior1Yr","category":"PAST_PERIOD"}],"updatedBy":{"id":"fbc4117a-4f2f-4e39-9d60-76563fa5b83e"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/definitions/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Prior Dx: Chronic Skin Ulcer","description":"HCC V22-M-161 Chronic Ulcer of Skin, Except Pressure (CLAIM)","messages":{"text":"Patient has been reported as having \"hypertensive heart and chronic kidney disease with heart failure,\" but no corresponding heart failure code has been submitted."},"catalog":"HealthecareCompany","type":"PRIOR","cohort":{"id":"4ee16093-bcb5-4ecd-b200-9bef190545cc"},"tags":[{"key":"INCLUDE_IN_CCFI_REPORT","value":"True"}],"aliases":[{"system":"HEALTHCARECOMPANY","value":"404"}],"components":[{"mnemonic":"ChronicSkinUlcerPrior1Yr","category":"PAST_PERIOD"}],"updatedBy":{"id":"fbc4117a-4f2f-4e39-9d60-76563fa5b83e"}}

PUT /definitions/{definitionId}

Updates a definition.

Parameters

Parameter In Type Required Default Description Accepted Values
definitionId path string true N/A The unique ID of the definition. -
body body putDefinitions true N/A No description -

Response Statuses

Status Meaning Description Schema
200 OK A single definition object Definition
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a Single Definition

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/condition-identification/v1/definitions/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/definitions/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /definitions/{definitionId}

Retrieves a single definition.

Parameters

Parameter In Type Required Default Description Accepted Values
definitionId path string true N/A The unique ID of the definition. -

Response Statuses

Status Meaning Description Schema
200 OK A single definition object Definition
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Configurations

The condition identification configuration defines how the condition identification outcomes should be produced. The configuration is used as the input instructions for the condition identification pipelines.

Create a Configuration

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/condition-identification/v1/configurations', headers: headers, body: {"name":"Condition identification production configuration.","description":"This condition identification configuration is for production.","population":{"id":"5d0f9ff9-d3b8-47e0-86a1-13d500d833ce"},"confidenceWeightIndex":{"id":"82a5df10-245d-4137-b185-056300ebbde3"},"conditionHierarchyIndex":{"id":"7d684c4b-301d-4a4f-b0a9-583aa6bd5057"},"definitions":[{"id":"3422c349-adbd-44d6-832b-03c6e788db4c"}],"createdBy":{"id":"c5693417-38ad-408d-a438-3581f416e512"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/configurations \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Condition identification production configuration.","description":"This condition identification configuration is for production.","population":{"id":"5d0f9ff9-d3b8-47e0-86a1-13d500d833ce"},"confidenceWeightIndex":{"id":"82a5df10-245d-4137-b185-056300ebbde3"},"conditionHierarchyIndex":{"id":"7d684c4b-301d-4a4f-b0a9-583aa6bd5057"},"definitions":[{"id":"3422c349-adbd-44d6-832b-03c6e788db4c"}],"createdBy":{"id":"c5693417-38ad-408d-a438-3581f416e512"}}

POST /configurations

Creates a configuration.

Parameters

Parameter In Type Required Default Description Accepted Values
body body postConfigurations true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created A configuration object Configuration
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 configuration.

Retrieve a List of Configurations

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/condition-identification/v1/configurations', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/configurations \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /configurations

Retrieves a list of configurations.

Parameters

Parameter In Type Required Default Description Accepted Values
id query array[string] false N/A The ID of the configuration. This query parameter can be repeated multiple times to query for multiple configurations at a time. -
name query string false N/A The name or partial name of the configuration. This filter is case insensitive. -
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 name,updatedAt A comma-separated list of fields by which to sort. name, -name, updatedAt, -updatedAt

Response Statuses

Status Meaning Description Schema
200 OK A collection of configuration objects Configurations
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error

Delete a Configuration

Example Request:


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

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

result = HTTParty.delete('https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/configurations/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/configurations/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /configurations/{configurationId}

Deletes a configuration.

Parameters

Parameter In Type Required Default Description Accepted Values
configurationId path string true N/A The unique ID of the configuration. -

Response Statuses

Status Meaning Description Schema
204 No Content No content None
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Update a Configuration

Example Request:




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

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

result = HTTParty.put('https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/configurations/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers, body: {"name":"Condition identification production configuration.","description":"This condition identification configuration is for production.","population":{"id":"5d0f9ff9-d3b8-47e0-86a1-13d500d833ce"},"confidenceWeightIndex":{"id":"82a5df10-245d-4137-b185-056300ebbde3"},"conditionHierarchyIndex":{"id":"7d684c4b-301d-4a4f-b0a9-583aa6bd5057"},"definitions":[{"id":"3422c349-adbd-44d6-832b-03c6e788db4c"}],"updatedBy":{"id":"fbc4117a-4f2f-4e39-9d60-76563fa5b83e"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/configurations/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Condition identification production configuration.","description":"This condition identification configuration is for production.","population":{"id":"5d0f9ff9-d3b8-47e0-86a1-13d500d833ce"},"confidenceWeightIndex":{"id":"82a5df10-245d-4137-b185-056300ebbde3"},"conditionHierarchyIndex":{"id":"7d684c4b-301d-4a4f-b0a9-583aa6bd5057"},"definitions":[{"id":"3422c349-adbd-44d6-832b-03c6e788db4c"}],"updatedBy":{"id":"fbc4117a-4f2f-4e39-9d60-76563fa5b83e"}}

PUT /configurations/{configurationId}

Updates a configuration.

Parameters

Parameter In Type Required Default Description Accepted Values
configurationId path string true N/A The unique ID of the configuration. -
body body putConfigurations true N/A No description -

Response Statuses

Status Meaning Description Schema
200 OK A single configuration object Configuration
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a Single Configuration

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/condition-identification/v1/configurations/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/configurations/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /configurations/{configurationId}

Retrieves a single configuration. The configuration retrieved is the most recently created version of the configuration.

Parameters

Parameter In Type Required Default Description Accepted Values
configurationId path string true N/A The unique ID of the configuration. -

Response Statuses

Status Meaning Description Schema
200 OK A single configuration object Configuration
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a List of Configuration Versions

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/condition-identification/v1/configurations/a426149a-c19c-413a-8d9f-d7988aec4a91/versions', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/configurations/a426149a-c19c-413a-8d9f-d7988aec4a91/versions \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /configurations/{configurationId}/versions

Retrieves a list of configuration versions.

Parameters

Parameter In Type Required Default Description Accepted Values
configurationId path string true N/A The unique ID of the configuration. -
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 version A comma-separated list of fields by which to sort. name, -name, version, -version, updatedAt, -updatedAt

Response Statuses

Status Meaning Description Schema
200 OK A collection of configuration objects Configurations
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a Single Configuration Version

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/condition-identification/v1/configurations/a426149a-c19c-413a-8d9f-d7988aec4a91/versions/57429182-e099-44d1-b436-3b098a370a46', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/configurations/a426149a-c19c-413a-8d9f-d7988aec4a91/versions/57429182-e099-44d1-b436-3b098a370a46 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /configurations/{configurationId}/versions/{versionNumber}

Retrieves a single configuration version.

Parameters

Parameter In Type Required Default Description Accepted Values
configurationId path string true N/A The unique ID of the configuration. -
versionNumber path integer(int32) true N/A The automatically incremented version number of the configuration. -

Response Statuses

Status Meaning Description Schema
200 OK A single configuration object Configuration
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Prior Diagnoses

A prior diagnosis is a diagnosis that has been conclusively identified for a patient based on identification logic. The identification outcome is typically based on the previous documentation of a condition through evidence from clinical or HCC-related inputs.

Retrieve a List of Prior Diagnoses

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/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/prior-diagnoses', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/prior-diagnoses \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "patient": {
        "id": "27d0677b-28e6-4648-9159-1e114eb7b829",
        "population": {
          "id": "5d0f9ff9-d3b8-47e0-86a1-13d500d833ce"
        }
      },
      "hierarchies": [
        {
          "group": {
            "name": "Obesity"
          },
          "isTrumped": true,
          "trumpedBy": [
            {
              "id": "2310677b-28e6-4648-9159-1e114eb7b829",
              "name": "Obesity (BMI ≥ 40) from claims"
            }
          ]
        }
      ],
      "confidenceWeight": {
        "weight": 0.74,
        "weightType": "SCHEDULE",
        "weightSchedule": {
          "name": "Schedule1 - Claims"
        }
      },
      "conditionIdentificationDefinition": {
        "id": "2310677b-28e6-4648-9159-1e114eb7b829",
        "name": "Obesity (BMI ≥ 40) from claims"
      },
      "pipeline": {
        "id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
        "instanceId": "0b424e9d-b74a-4b78-9dde-22685ae9cdec"
      },
      "recommendationMessages": [
        {
          "formatType": "TEXT",
          "message": "Suspected/Prior Dx: Obesity (BMI >/= 40) (ICD10 E66.9) was last reported on 23 Jan 2017. If still present, please address clinically and submit appropriate diagnosis code.\n",
          "recommendationPolicy": {
            "id": "6310677b-28e6-4648-9159-1e114eb7b828",
            "title": "Alerts for the condition identifications"
          }
        }
      ],
      "pastPeriodSupportingData": [
        {
          "componentMnemonic": "ObesityDxPriorYears",
          "isSatisfied": true,
          "basis": [
            {
              "id": "e8f0e126-2e4b-11e9-b210-d663bd873d93",
              "kind": "condition#condition"
            }
          ]
        }
      ],
      "currentPeriodSupportingData": [
        {
          "componentMnemonic": "ObesityDxPriorYears",
          "isSatisfied": true,
          "basis": [
            {
              "id": "e8f0e126-2e4b-11e9-b210-d663bd873d93",
              "kind": "condition#condition"
            }
          ]
        }
      ],
      "identificationStatus": "NEEDS_CURRENT_PERIOD_ATTENTION"
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/a426149a-c19c-413a-8d9f-d7988aec4a91/patients/27d0677b-28e6-4648-9159-1e114eb7b829/prior-diagnoses?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/a426149a-c19c-413a-8d9f-d7988aec4a91/patients/27d0677b-28e6-4648-9159-1e114eb7b829/prior-diagnoses?offset=0&limit=20"
}

GET /pipelines/{pipelineId}/patients/{patientId}/prior-diagnoses

Retrieves a list of prior diagnoses.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The ID of the condition identification pipeline. -
patientId path string true N/A The ID of the patient. -
includeTrumped query boolean false N/A Indicates whether the condition identification outcome is included in the response when it is trumped in any of its condition hierarchies. -
identificationStatus query array[string] false N/A The identification status of the condition identification outcome. -
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. -

Response Statuses

Status Meaning Description Schema
200 OK A collection of prior diagnosis objects PriorDiagnoses
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Suspected Diagnoses

A suspected diagnosis is a diagnosis that has been identified for a patient based on inclusion and exclusion criteria.

Retrieve a List of Suspected Diagnoses

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/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/suspected-diagnoses', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/suspected-diagnoses \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "patient": {
        "id": "27d0677b-28e6-4648-9159-1e114eb7b829",
        "population": {
          "id": "5d0f9ff9-d3b8-47e0-86a1-13d500d833ce"
        }
      },
      "hierarchies": [
        {
          "group": {
            "name": "Obesity"
          },
          "isTrumped": true,
          "trumpedBy": [
            {
              "id": "2310677b-28e6-4648-9159-1e114eb7b829",
              "name": "Obesity (BMI ≥ 40) from claims"
            }
          ]
        }
      ],
      "confidenceWeight": {
        "weight": 0.74,
        "weightType": "SCHEDULE",
        "weightSchedule": {
          "name": "Schedule1 - Claims"
        }
      },
      "conditionIdentificationDefinition": {
        "id": "2310677b-28e6-4648-9159-1e114eb7b829",
        "name": "Obesity (BMI ≥ 40) from claims"
      },
      "recommendationMessages": [
        {
          "formatType": "TEXT",
          "message": "Suspected/Prior Dx: Obesity (BMI >/= 40) (ICD10 E66.9) was last reported on 23 Jan 2017. If still present, please address clinically and submit appropriate diagnosis code.\n",
          "recommendationPolicy": {
            "id": "6310677b-28e6-4648-9159-1e114eb7b828",
            "title": "Alerts for the condition identifications"
          }
        }
      ],
      "pipeline": {
        "id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
        "instanceId": "0b424e9d-b74a-4b78-9dde-22685ae9cdec"
      },
      "supportingData": [
        {
          "componentMnemonic": "ObesityDxPriorYears",
          "isSatisfied": true,
          "basis": [
            {
              "id": "e8f0e126-2e4b-11e9-b210-d663bd873d93",
              "kind": "condition#condition"
            }
          ]
        }
      ],
      "competingData": [
        {
          "componentMnemonic": "ObesityDxPriorYears",
          "isSatisfied": true,
          "basis": [
            {
              "id": "e8f0e126-2e4b-11e9-b210-d663bd873d93",
              "kind": "condition#condition"
            }
          ]
        }
      ]
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/d8454f2a-665c-49d4-87db-8c167feae10e/patients/27d0677b-28e6-4648-9159-1e114eb7b829/suspected_diagnoses?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/d8454f2a-665c-49d4-87db-8c167feae10e/patients/27d0677b-28e6-4648-9159-1e114eb7b829/suspected_diagnoses?offset=0&limit=20"
}

GET /pipelines/{pipelineId}/patients/{patientId}/suspected-diagnoses

Retrieves a list of suspected diagnoses.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The ID of the condition identification pipeline. -
patientId path string true N/A The ID of the patient. -
includeTrumped query boolean false N/A Indicates whether the condition identification outcome is included in the response when it is trumped in any of its condition hierarchies. -
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. -

Response Statuses

Status Meaning Description Schema
200 OK A collection of suspected diagnosis objects SuspectedDiagnoses
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Diagnosis Clarifications

Diagnosis clarifications identify situations where an existing diagnosis may require clarification and potential modification. These situations are most frequently seen when a diagnosis is not sufficiently specified based on additional supporting data, but diagnosis clarifications can also be used for other situations.

Retrieve a List of Diagnosis Clarifications

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/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/diagnosis-clarifications', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/diagnosis-clarifications \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "patient": {
        "id": "27d0677b-28e6-4648-9159-1e114eb7b829",
        "population": {
          "id": "5d0f9ff9-d3b8-47e0-86a1-13d500d833ce"
        }
      },
      "hierarchies": [
        {
          "group": {
            "name": "Obesity"
          },
          "isTrumped": true,
          "trumpedBy": [
            {
              "id": "2310677b-28e6-4648-9159-1e114eb7b829",
              "name": "Obesity (BMI ≥ 40) from claims"
            }
          ]
        }
      ],
      "confidenceWeight": {
        "weight": 0.74,
        "weightType": "SCHEDULE",
        "weightSchedule": {
          "name": "Schedule1 - Claims"
        }
      },
      "conditionIdentificationDefinition": {
        "id": "2310677b-28e6-4648-9159-1e114eb7b829",
        "name": "Obesity (BMI ≥ 40) from claims"
      },
      "recommendationMessages": [
        {
          "formatType": "TEXT",
          "message": "Suspected/Prior Dx: Obesity (BMI >/= 40) (ICD10 E66.9) was last reported on 23 Jan 2017. If still present, please address clinically and submit appropriate diagnosis code.\n",
          "recommendationPolicy": {
            "id": "6310677b-28e6-4648-9159-1e114eb7b828",
            "title": "Alerts for the condition identifications"
          }
        }
      ],
      "pipeline": {
        "id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
        "instanceId": "0b424e9d-b74a-4b78-9dde-22685ae9cdec"
      },
      "supportingData": [
        {
          "componentMnemonic": "ObesityDxPriorYears",
          "isSatisfied": true,
          "basis": [
            {
              "id": "e8f0e126-2e4b-11e9-b210-d663bd873d93",
              "kind": "condition#condition"
            }
          ]
        }
      ]
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/d8454f2a-665c-49d4-87db-8c167feae10e/patients/27d0677b-28e6-4648-9159-1e114eb7b829/diagnosis-clarifications?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/d8454f2a-665c-49d4-87db-8c167feae10e/patients/27d0677b-28e6-4648-9159-1e114eb7b829/diagnosis-clarifications?offset=0&limit=20"
}

GET /pipelines/{pipelineId}/patients/{patientId}/diagnosis-clarifications

Retrieves a list of diagnosis clarifications.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The ID of the condition identification pipeline. -
patientId path string true N/A The ID of the patient. -
includeTrumped query boolean false N/A Indicates whether the condition identification outcome is included in the response when it is trumped in any of its condition hierarchies. -
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. -

Response Statuses

Status Meaning Description Schema
200 OK A collection of diagnosis clarification objects DiagnosisClarifications
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Pipeline

A condition identification pipeline is an isolated execution environment for processing condition identification-related outcomes. The pipeline is required to generate and access patient-level condition identification data.

Create a Pipeline

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/condition-identification/v1/pipelines', headers: headers, body: {"createdBy":{"id":"f89fa3dd-57a8-494b-b157-4640ccc081e3"},"name":"Condition identification production pipeline","configuration":{"id":"a426149a-c19c-413a-8d9f-d7988aec4a91"},"status":"DRAFT"}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"createdBy":{"id":"f89fa3dd-57a8-494b-b157-4640ccc081e3"},"name":"Condition identification production pipeline","configuration":{"id":"a426149a-c19c-413a-8d9f-d7988aec4a91"},"status":"DRAFT"}

Example response

{
  "id": "09caa9f6-c384-4ad4-a4e2-203e1acee6db",
  "instanceId": "3d3cc121-31f3-4472-81e3-5983254d44f6",
  "name": "Condition identification production pipeline",
  "configuration": {
    "id": "b87dc60a-e421-4264-9da4-ad49854e6f69"
  },
  "status": "DRAFT",
  "createdAt": "2018-05-14T12:23:12Z",
  "createdBy": {
    "id": "d7edf791-7ef6-433c-a6f9-49dbc09f24a3"
  }
}

POST /pipelines

Creates a pipeline.

Parameters

Parameter In Type Required Default Description Accepted Values
body body postPipelines true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created A pipeline object Pipeline
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 pipeline.

Retrieve a List of Pipelines

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/condition-identification/v1/pipelines', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
      "instanceId": "3d3cc121-31f3-4472-81e3-5983254d44f6",
      "name": "Condition identification production pipeline",
      "configuration": {
        "id": "b87dc60a-e421-4264-9da4-ad49854e6f69"
      },
      "status": "DRAFT",
      "createdAt": "2018-05-14T12:23:12Z",
      "createdBy": {
        "id": "d7edf791-7ef6-433c-a6f9-49dbc09f24a3"
      }
    }
  ],
  "totalResults": 21,
  "firstLink": "https://cernerdemo.api.us.healtheintent.com/condition-identification/v1/pipelines?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us.healtheintent.com/condition-identification/v1/pipelines?offset=20&limit=20",
  "prevLink": "https://cernerdemo.api.us.healtheintent.com/condition-identification/v1/pipelines?offset=0&limit=20",
  "nextLink": "https://cernerdemo.api.us.healtheintent.com/condition-identification/v1/pipelines?offset=20&limit=20"
}

GET /pipelines

Retrieves a list of pipelines.

Parameters

Parameter In Type Required Default Description Accepted Values
configurationId query array[string] false N/A The configuration ID of the pipeline. This query parameter can be repeated multiple times to query for multiple configurations at a time. -
status query array[string] false N/A The status of the pipeline. This query parameter can be repeated multiple times to query for multiple statuses at a time. The API returns all pipelines regardless of status by default. -
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 name A comma-separated list of fields by which to sort. name, -name, createdAt, -createdAt

Response Statuses

Status Meaning Description Schema
200 OK A collection of pipeline objects Pipelines
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error

Retrieve a Single Pipeline

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/condition-identification/v1/pipelines/206d2277-827b-478e-b543-308e28d74fdc', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/206d2277-827b-478e-b543-308e28d74fdc \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /pipelines/{pipelineId}

Retrieves a single pipeline.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The unique ID of the pipeline. -

Response Statuses

Status Meaning Description Schema
200 OK Retrieves a single pipeline. Pipeline
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Create a Pipeline Instance

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/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/instances', headers: headers, body: {"createdBy":{"id":"f89fa3dd-57a8-494b-b157-4640ccc081e3"},"name":"Condition identification production pipeline","configuration":{"id":"a426149a-c19c-413a-8d9f-d7988aec4a91"},"status":"DRAFT"}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/instances \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"createdBy":{"id":"f89fa3dd-57a8-494b-b157-4640ccc081e3"},"name":"Condition identification production pipeline","configuration":{"id":"a426149a-c19c-413a-8d9f-d7988aec4a91"},"status":"DRAFT"}

Example response

{
  "id": "09caa9f6-c384-4ad4-a4e2-203e1acee6db",
  "instanceId": "3d3cc121-31f3-4472-81e3-5983254d44f6",
  "name": "Condition identification production pipeline",
  "configuration": {
    "id": "b87dc60a-e421-4264-9da4-ad49854e6f69"
  },
  "status": "DRAFT",
  "createdAt": "2018-05-14T12:23:12Z",
  "createdBy": {
    "id": "d7edf791-7ef6-433c-a6f9-49dbc09f24a3"
  }
}

POST /pipelines/{pipelineId}/instances

Creates a pipeline instance.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The unique ID of the pipeline. -
body body postPipelinesPipelineidInstances true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created A pipeline instance object Pipeline
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 pipeline instance.

Retrieve a List of Pipeline Instances

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/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/instances', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/instances \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
      "instanceId": "3d3cc121-31f3-4472-81e3-5983254d44f6",
      "name": "Condition identification production pipeline",
      "configuration": {
        "id": "b87dc60a-e421-4264-9da4-ad49854e6f69"
      },
      "status": "DRAFT",
      "createdAt": "2018-05-14T12:23:12Z",
      "createdBy": {
        "id": "d7edf791-7ef6-433c-a6f9-49dbc09f24a3"
      }
    }
  ],
  "totalResults": 21,
  "firstLink": "https://cernerdemo.api.us.healtheintent.com/condition-identification/v1/pipelines?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us.healtheintent.com/condition-identification/v1/pipelines?offset=20&limit=20",
  "prevLink": "https://cernerdemo.api.us.healtheintent.com/condition-identification/v1/pipelines?offset=0&limit=20",
  "nextLink": "https://cernerdemo.api.us.healtheintent.com/condition-identification/v1/pipelines?offset=20&limit=20"
}

GET /pipelines/{pipelineId}/instances

Retrieves a list of pipeline instances.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The unique ID of the pipeline. -
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 -createdAt A comma-separated list of fields by which to sort. createdAt, -createdAt

Response Statuses

Status Meaning Description Schema
200 OK A collection of pipeline instance objects Pipelines
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error

Retrieve a Single Pipeline Instance

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/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/instances/206d2277-827b-478e-b543-308e28d74fdc', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/instances/206d2277-827b-478e-b543-308e28d74fdc \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /pipelines/{pipelineId}/instances/{instanceId}

Retrieves a single pipeline instance.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The unique ID of the pipeline. -
instanceId path string true N/A The ID of the instance of the condition identification pipeline. -

Response Statuses

Status Meaning Description Schema
200 OK Retrieves a single pipeline instance. Pipeline
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Confidence Weight Index

A confidence weight index is a representation of the content that is used to calculate the confidence weights of condition identification outcomes.

Create a Confidence Weight Index

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/condition-identification/v1/confidence-weight-indexes', headers: headers, body: {"name":"Confidence Weight - 2019","description":"Calibrated weight","index":{"name":"confidence-weights-2019","fields":[{"name":"ACTIVE_TREATMENT","dataType":"BOOLEAN"}],"directWeights":[{"conditionIdentificationDefinition":{"id":"2310677b-28e6-4648-9159-1e114eb7b829"},"weight":0.45}],"scheduleWeights":[{"name":"Schedule 1 - Claims","conditionIdentificationDefinitions":[{"id":"2310677b-28e6-4648-9159-1e114eb7b829"}],"weightFunctions":[{"tests":[{"field":"PAST_3_YEARS_CONDITION_COUNT","operator":"EQ","value":"2"}],"weight":0.77}]}]},"createdBy":{"id":"c5693417-38ad-408d-a438-3581f416e512"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/confidence-weight-indexes \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Confidence Weight - 2019","description":"Calibrated weight","index":{"name":"confidence-weights-2019","fields":[{"name":"ACTIVE_TREATMENT","dataType":"BOOLEAN"}],"directWeights":[{"conditionIdentificationDefinition":{"id":"2310677b-28e6-4648-9159-1e114eb7b829"},"weight":0.45}],"scheduleWeights":[{"name":"Schedule 1 - Claims","conditionIdentificationDefinitions":[{"id":"2310677b-28e6-4648-9159-1e114eb7b829"}],"weightFunctions":[{"tests":[{"field":"PAST_3_YEARS_CONDITION_COUNT","operator":"EQ","value":"2"}],"weight":0.77}]}]},"createdBy":{"id":"c5693417-38ad-408d-a438-3581f416e512"}}

POST /confidence-weight-indexes

Creates a confidence weight index.

Parameters

Parameter In Type Required Default Description Accepted Values
body body postConfidenceWeightIndexes true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created The confidence weight index was created. ConfidenceWeightIndex
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error

Retrieve a List of Confidence Weight Indexes

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/condition-identification/v1/confidence-weight-indexes', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/confidence-weight-indexes \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /confidence-weight-indexes

Retrieves a list of confidence weight indexes.

Parameters

Parameter In Type Required Default Description Accepted Values
name query string false N/A The name of the confidence weight index. -
id query array[string] false N/A An array of confidence weight index IDs. -
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 name A comma-separated list of fields by which to sort. name, -name, updatedAt, -updatedAt

Response Statuses

Status Meaning Description Schema
200 OK A collection of confidence weight indexes ConfidenceWeightIndices
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error

Delete a Confidence Weight Index

Example Request:


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

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

result = HTTParty.delete('https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/confidence-weight-indexes/18387d2a-3930-4744-aff9-d60ad3a4f140', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/confidence-weight-indexes/18387d2a-3930-4744-aff9-d60ad3a4f140 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /confidence-weight-indexes/{confidenceWeightIndexId}

Deletes a confidence weight index by ID.

Parameters

Parameter In Type Required Default Description Accepted Values
confidenceWeightIndexId path string true N/A The unique ID of the confidence weight. -

Response Statuses

Status Meaning Description Schema
204 No Content The confidence weight index was deleted. None
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Update a Confidence Weight Index

Example Request:




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

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

result = HTTParty.put('https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/confidence-weight-indexes/18387d2a-3930-4744-aff9-d60ad3a4f140', headers: headers, body: {"name":"Confidence Weight - 2019","description":"Calibrated weight","index":{"name":"confidence-weights-2019","fields":[{"name":"ACTIVE_TREATMENT","dataType":"BOOLEAN"}],"directWeights":[{"conditionIdentificationDefinition":{"id":"2310677b-28e6-4648-9159-1e114eb7b829"},"weight":0.45}],"scheduleWeights":[{"name":"Schedule 1 - Claims","conditionIdentificationDefinitions":[{"id":"2310677b-28e6-4648-9159-1e114eb7b829"}],"weightFunctions":[{"tests":[{"field":"PAST_3_YEARS_CONDITION_COUNT","operator":"EQ","value":"2"}],"weight":0.77}]}]},"updatedBy":{"id":"fbc4117a-4f2f-4e39-9d60-76563fa5b83e"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/confidence-weight-indexes/18387d2a-3930-4744-aff9-d60ad3a4f140 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Confidence Weight - 2019","description":"Calibrated weight","index":{"name":"confidence-weights-2019","fields":[{"name":"ACTIVE_TREATMENT","dataType":"BOOLEAN"}],"directWeights":[{"conditionIdentificationDefinition":{"id":"2310677b-28e6-4648-9159-1e114eb7b829"},"weight":0.45}],"scheduleWeights":[{"name":"Schedule 1 - Claims","conditionIdentificationDefinitions":[{"id":"2310677b-28e6-4648-9159-1e114eb7b829"}],"weightFunctions":[{"tests":[{"field":"PAST_3_YEARS_CONDITION_COUNT","operator":"EQ","value":"2"}],"weight":0.77}]}]},"updatedBy":{"id":"fbc4117a-4f2f-4e39-9d60-76563fa5b83e"}}

PUT /confidence-weight-indexes/{confidenceWeightIndexId}

Updates a confidence weight index by ID.

Parameters

Parameter In Type Required Default Description Accepted Values
confidenceWeightIndexId path string true N/A The unique ID of the confidence weight. -
body body putConfidenceWeightIndexes true N/A No description -

Response Statuses

Status Meaning Description Schema
200 OK The confidence weight index was updated. ConfidenceWeightIndex
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a Single Confidence Weight Index

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/condition-identification/v1/confidence-weight-indexes/18387d2a-3930-4744-aff9-d60ad3a4f140', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/confidence-weight-indexes/18387d2a-3930-4744-aff9-d60ad3a4f140 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /confidence-weight-indexes/{confidenceWeightIndexId}

Retrieves a confidence weight index by ID.

Parameters

Parameter In Type Required Default Description Accepted Values
confidenceWeightIndexId path string true N/A The unique ID of the confidence weight. -

Response Statuses

Status Meaning Description Schema
200 OK A confidence weight index ConfidenceWeightIndex
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a List of Confidence Weight Versions

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/condition-identification/v1/confidence-weight-indexes/18387d2a-3930-4744-aff9-d60ad3a4f140/versions', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/confidence-weight-indexes/18387d2a-3930-4744-aff9-d60ad3a4f140/versions \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /confidence-weight-indexes/{confidenceWeightIndexId}/versions

Retrieves a list of confidence weight index versions.

Parameters

Parameter In Type Required Default Description Accepted Values
confidenceWeightIndexId path string true N/A The unique ID of the confidence weight. -
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 version A comma-separated list of fields by which to sort. version, -version

Response Statuses

Status Meaning Description Schema
200 OK A collection of confidence weight index versions ConfidenceWeightIndices
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a Confidence Weight Index Version

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/condition-identification/v1/confidence-weight-indexes/18387d2a-3930-4744-aff9-d60ad3a4f140/versions/1', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/confidence-weight-indexes/18387d2a-3930-4744-aff9-d60ad3a4f140/versions/1 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /confidence-weight-indexes/{confidenceWeightIndexId}/versions/{versionId}

Retrieves a single confidence weight version by ID.

Parameters

Parameter In Type Required Default Description Accepted Values
confidenceWeightIndexId path string true N/A The unique ID of the confidence weight. -
versionId path integer(int32) true N/A The automatically incremented version ID of the confidence weight. -

Response Statuses

Status Meaning Description Schema
200 OK A single confidence weight index version ConfidenceWeightIndex
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Hierarchy Index

A hierarchy index represents a collection of condition groupings. Each condition grouping has its own definition of a hierarchy that ranks how different condition identification definitions compare to each other. The rankings of condition identification definitions should always start with the highest-priority item being a rank of 1, then all other items can be a number greater than 1. The ranking values do not need to be sequential, but they should be integers.

Create a Condition Hierarchy Index

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/condition-identification/v1/hierarchy-indexes', headers: headers, body: {"name":"condition-hierarchy-2019","description":"condition identification measure hierarchy set 2019 for CLAIMS and MOR","groups":[{"name":"Amputation","rankedConditionDefinitions":[{"conditionIdentificationDefinitionId":"a36955ce-f1ee-4703-8680-1c30a9c66e7c","ranking":1}]}],"createdBy":"26fcddb0-0b6f-4cbd-b292-43db0cc20230"}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/hierarchy-indexes \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"condition-hierarchy-2019","description":"condition identification measure hierarchy set 2019 for CLAIMS and MOR","groups":[{"name":"Amputation","rankedConditionDefinitions":[{"conditionIdentificationDefinitionId":"a36955ce-f1ee-4703-8680-1c30a9c66e7c","ranking":1}]}],"createdBy":"26fcddb0-0b6f-4cbd-b292-43db0cc20230"}

POST /hierarchy-indexes

Creates a condition hierarchy index.

Parameters

Parameter In Type Required Default Description Accepted Values
body body postHierarchyIndexes true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created The condition hierarchy index was created HierarchyIndex
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error

Retrieve a List of Hierarchy Indexes

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/condition-identification/v1/hierarchy-indexes', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/hierarchy-indexes \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "condition-hierarchy-2019",
      "description": "condition identification measure hierarchy set 2019 for CLAIMS and MOR",
      "groups": [
        {
          "id": "e36955ce-f1ee-4703-8680-1c30a9c66e7b",
          "name": "Amputation",
          "rankedConditionDefinitions": [
            {
              "conditionIdentificationDefinitionId": "a36955ce-f1ee-4703-8680-1c30a9c66e7c",
              "ranking": 1
            },
            {
              "conditionIdentificationDefinitionId": "b36955ce-f1ee-4703-8680-1c30a9c66e7b",
              "ranking": 2
            }
          ]
        }
      ],
      "version": "2",
      "createdAt": "2020-1-29T06:25:13Z",
      "createdBy": "26fcddb0-0b6f-4cbd-b292-43db0cc20230",
      "updatedAt": "2020-07-29T06:25:13Z",
      "updatedBy": "26fcddb0-0b6f-4cbd-b292-43db0cc20230"
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/hierarchy_indexes?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/hierarchy_indexes?offset=0&limit=20"
}

GET /hierarchy-indexes

Retrieves a list of hierarchy indexes.

Parameters

Parameter In Type Required Default Description Accepted Values
name query string false N/A The name to use to search for condition hierarchy indexes. -
hierarchyIndexId query array[string] false N/A An array of hierarchy index IDs. -
orderBy query string false name The value in which to order by. name, -name, createdAt, -createdAt
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. -

Response Statuses

Status Meaning Description Schema
200 OK A collection of hierarchy indexes HierarchyIndices
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error

Delete a Hierarchy Index

Example Request:


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

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

result = HTTParty.delete('https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/hierarchy-indexes/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/hierarchy-indexes/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /hierarchy-indexes/{hierarchyIndexId}

Deletes a condition hierarchy index by ID.

Parameters

Parameter In Type Required Default Description Accepted Values
hierarchyIndexId path integer(int32) true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content The hierarchy index was deleted None
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Update a Hierarchy Index

Example Request:




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

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

result = HTTParty.put('https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/hierarchy-indexes/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers, body: {"name":"condition-hierarchy-2019","description":"condition identification measure hierarchy set 2019 for CLAIMS and MOR","groups":[{"name":"Amputation","rankedConditionDefinitions":[{"conditionIdentificationDefinitionId":"a36955ce-f1ee-4703-8680-1c30a9c66e7c","ranking":1}]}],"createdBy":"26fcddb0-0b6f-4cbd-b292-43db0cc20230"}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/hierarchy-indexes/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"condition-hierarchy-2019","description":"condition identification measure hierarchy set 2019 for CLAIMS and MOR","groups":[{"name":"Amputation","rankedConditionDefinitions":[{"conditionIdentificationDefinitionId":"a36955ce-f1ee-4703-8680-1c30a9c66e7c","ranking":1}]}],"createdBy":"26fcddb0-0b6f-4cbd-b292-43db0cc20230"}

PUT /hierarchy-indexes/{hierarchyIndexId}

Updates a hierarchy index by ID.

Parameters

Parameter In Type Required Default Description Accepted Values
hierarchyIndexId path integer(int32) true N/A No description -
body body putHierarchyIndexes true N/A No description -

Response Statuses

Status Meaning Description Schema
200 OK The hierarchy index was updated HierarchyIndex
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a Single Hierarchy Index

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/condition-identification/v1/hierarchy-indexes/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/hierarchy-indexes/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /hierarchy-indexes/{hierarchyIndexId}

Retrieves a hierarchy index by ID.

Parameters

Parameter In Type Required Default Description Accepted Values
hierarchyIndexId path integer(int32) true N/A No description -

Response Statuses

Status Meaning Description Schema
200 OK A hierarchy index HierarchyIndex
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a List of Hierarchy Index Versions

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/condition-identification/v1/hierarchy-indexes/a426149a-c19c-413a-8d9f-d7988aec4a91/versions', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/hierarchy-indexes/a426149a-c19c-413a-8d9f-d7988aec4a91/versions \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "condition-hierarchy-2019",
      "description": "condition identification measure hierarchy set 2019 for CLAIMS and MOR",
      "groups": [
        {
          "id": "e36955ce-f1ee-4703-8680-1c30a9c66e7b",
          "name": "Amputation",
          "rankedConditionDefinitions": [
            {
              "conditionIdentificationDefinitionId": "a36955ce-f1ee-4703-8680-1c30a9c66e7c",
              "ranking": 1
            },
            {
              "conditionIdentificationDefinitionId": "b36955ce-f1ee-4703-8680-1c30a9c66e7b",
              "ranking": 2
            }
          ]
        }
      ],
      "version": "2",
      "createdAt": "2020-1-29T06:25:13Z",
      "createdBy": "26fcddb0-0b6f-4cbd-b292-43db0cc20230",
      "updatedAt": "2020-07-29T06:25:13Z",
      "updatedBy": "26fcddb0-0b6f-4cbd-b292-43db0cc20230"
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/hierarchy_indexes?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/hierarchy_indexes?offset=0&limit=20"
}

GET /hierarchy-indexes/{hierarchy_index_id}/versions

Retrieves a list of hierarchy index versions.

Parameters

Parameter In Type Required Default Description Accepted Values
hierarchyIndexId query string false N/A An array of hierarchy index IDs. -
orderBy query string false -version The value in which to order by. version, -version, name, -name
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. -
hierarchy_index_id path integer(int32) true N/A No description -

Response Statuses

Status Meaning Description Schema
200 OK A collection of hierarchy index versions HierarchyIndices
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a Hierarchy Index Version

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/condition-identification/v1/hierarchy-indexes/a426149a-c19c-413a-8d9f-d7988aec4a91/versions/1', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/hierarchy-indexes/a426149a-c19c-413a-8d9f-d7988aec4a91/versions/1 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /hierarchy-indexes/{hierarchy_index_id}/versions/{version_id}

Retrieves a hierarchy index version by ID.

Parameters

Parameter In Type Required Default Description Accepted Values
hierarchy_index_id path integer(int32) true N/A No description -
version_id path integer(int32) true N/A No description -

Response Statuses

Status Meaning Description Schema
200 OK A hierarchy index version HierarchyIndex
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Condition Options

Condition options represent the potential diagnosis options that are available that provide more appropriate codes to consider when adding a diagnosis to a condition.

Retrieve a List of Condition Options

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/condition-identification/v1/condition-options', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/condition-options \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /condition-options

Retrieves a list of condition options.

Parameters

Parameter In Type Required Default Description Accepted Values
id query array[string] false N/A The ID of the condition option. This query parameter can be repeated multiple times to query for multiple condition options at a time. -
conditionIdentificationDefinitionId query array[string] false N/A The ID of the condition identification definition. This query parameter can be repeated multiple times to query for multiple condition options at a time. -
title query string false N/A The user-friendly name of the condition option. This filter is case-insensitive. -
updatedAt query string false N/A The date and time when the condition option was udpated. This filter is case-insensitive. -
usage query array[string] false N/A The context being used for this condition option. Valid values include DIAGNOSIS and PROBLEM. This filter is case-insensitive. -
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 updatedAt A comma-separated list of fields by which to sort. title, -title, updatedAt, -updatedAt

Response Statuses

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

Create a Condition Option

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/condition-identification/v1/condition-options', headers: headers, body: {"name":"Diabetes mellitus with other specified complication","title":"Type 2 Diabetes mellitus with other specified complication","usage":"DIAGNOSIS","conditionIdentificationDefinition":{"id":"2310677b-28e6-4648-9159-1e114eb7b829","alias":{"system":"HEALTHCARECOMPANY","value":"404"}},"default":"true","codes":[{"code":"E11.69","display":"Type 2 diabetes mellitus with other specified complication","system":"2.16.840.1.113883.6.90","preferred":"true"}],"createdBy":{"id":"c5693417-38ad-408d-a438-3581f416e512"},"aliases":[{"system":"HEALTHCARECOMPANY","value":"404"}],"updatedBy":{"id":"fbc4117a-4f2f-4e39-9d60-76563fa5b83e"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/condition-options \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Diabetes mellitus with other specified complication","title":"Type 2 Diabetes mellitus with other specified complication","usage":"DIAGNOSIS","conditionIdentificationDefinition":{"id":"2310677b-28e6-4648-9159-1e114eb7b829","alias":{"system":"HEALTHCARECOMPANY","value":"404"}},"default":"true","codes":[{"code":"E11.69","display":"Type 2 diabetes mellitus with other specified complication","system":"2.16.840.1.113883.6.90","preferred":"true"}],"createdBy":{"id":"c5693417-38ad-408d-a438-3581f416e512"},"aliases":[{"system":"HEALTHCARECOMPANY","value":"404"}],"updatedBy":{"id":"fbc4117a-4f2f-4e39-9d60-76563fa5b83e"}}

POST /condition-options

Creates a condition option.

Parameters

Parameter In Type Required Default Description Accepted Values
body body postConditionOptions true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created A condition option object ConditionOption
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 option.

Delete a Condition Option

Example Request:


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

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

result = HTTParty.delete('https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/condition-options/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/condition-options/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /condition-options/{conditionOptionId}

Deletes a condition option.

Parameters

Parameter In Type Required Default Description Accepted Values
conditionOptionId path string true N/A The unique ID of the condition option. -

Response Statuses

Status Meaning Description Schema
204 No Content No content None
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a Single Condition Option

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/condition-identification/v1/condition-options/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/condition-options/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /condition-options/{conditionOptionId}

Retrieves a single condition option.

Parameters

Parameter In Type Required Default Description Accepted Values
conditionOptionId path string true N/A The unique ID of the condition option. -

Response Statuses

Status Meaning Description Schema
200 OK A single condition option object ConditionOption
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Update a Condition Option

Example Request:




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

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

result = HTTParty.put('https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/condition-options/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers, body: {"name":"Diabetes mellitus with other specified complication","title":"Type 2 Diabetes mellitus with other specified complication","usage":"DIAGNOSIS","conditionIdentificationDefinition":{"id":"2310677b-28e6-4648-9159-1e114eb7b829","alias":{"system":"HEALTHCARECOMPANY","value":"404"}},"default":"true","codes":[{"code":"E11.69","display":"Type 2 diabetes mellitus with other specified complication","system":"2.16.840.1.113883.6.90","preferred":"true"}],"updatedBy":{"id":"fbc4117a-4f2f-4e39-9d60-76563fa5b83e"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/condition-options/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Diabetes mellitus with other specified complication","title":"Type 2 Diabetes mellitus with other specified complication","usage":"DIAGNOSIS","conditionIdentificationDefinition":{"id":"2310677b-28e6-4648-9159-1e114eb7b829","alias":{"system":"HEALTHCARECOMPANY","value":"404"}},"default":"true","codes":[{"code":"E11.69","display":"Type 2 diabetes mellitus with other specified complication","system":"2.16.840.1.113883.6.90","preferred":"true"}],"updatedBy":{"id":"fbc4117a-4f2f-4e39-9d60-76563fa5b83e"}}

PUT /condition-options/{conditionOptionId}

Updates a condition option.

Parameters

Parameter In Type Required Default Description Accepted Values
conditionOptionId path string true N/A The unique ID of the condition option. -
body body putConditionOptions true N/A No description -

Response Statuses

Status Meaning Description Schema
200 OK A single condition option object ConditionOption
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Recommendation Policy

A recommendation policy is the set of conditions that qualify what conditional alerts or instructional messages are appropriate to the condition measure based on the data present in a condition identification-based outcome.

Create a Recommendation Policy

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/condition-identification/v1/recommendation-policies', headers: headers, body: {"name":"Prior-dx-Cardio-Resp-Failure-Recimmendation","title":"Prior Dx: Heart Failure","fields":[{"name":"IdentificationStatus","type":"BOOLEAN","value":"true"},{"name":"HierarchicalConditionCategoryNumber","type":"NUMBER","value":"123"}],"conditionIdentificationDefinition":{"id":"49d0677b-28e6-4648-9159-1e114eb7b829","alias":{"system":"LOCAL","value":123}},"tests":[{"field":"IdentificationStatus","operator":"EQ","value":"NEEDS_CURRENT_PERIOD_ATTENTION"}],"messages":[{"format":"TEXT","template":"Prior Dx: This condition was reported previously. If still present, please address clinically and submit appropriate diagnosis code."}],"createdBy":{"id":"c5693417-38ad-408d-a438-3581f416e512"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/recommendation-policies \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Prior-dx-Cardio-Resp-Failure-Recimmendation","title":"Prior Dx: Heart Failure","fields":[{"name":"IdentificationStatus","type":"BOOLEAN","value":"true"},{"name":"HierarchicalConditionCategoryNumber","type":"NUMBER","value":"123"}],"conditionIdentificationDefinition":{"id":"49d0677b-28e6-4648-9159-1e114eb7b829","alias":{"system":"LOCAL","value":123}},"tests":[{"field":"IdentificationStatus","operator":"EQ","value":"NEEDS_CURRENT_PERIOD_ATTENTION"}],"messages":[{"format":"TEXT","template":"Prior Dx: This condition was reported previously. If still present, please address clinically and submit appropriate diagnosis code."}],"createdBy":{"id":"c5693417-38ad-408d-a438-3581f416e512"}}

POST /recommendation-policies

Creates a recommendation policy for a condition identification definition.

Parameters

Parameter In Type Required Default Description Accepted Values
body body postRecommendationPolicies true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created The recommendation policy object was created RecommendationPolicy
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error

Retrieve a List of Recommendation Policies

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/condition-identification/v1/recommendation-policies', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/recommendation-policies \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /recommendation-policies

Retrieves a list of recommendation policies.

Parameters

Parameter In Type Required Default Description Accepted Values
title query string false N/A The full or partial name of the recommendation policy. -
id query array[string] false N/A The ID of the recommendation policy. This query parameter can be repeated multiple times to query for multiple recommendation policies at a time. -
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 title A comma-separated list of fields by which to sort. title, -title, createdAt, -createdAt

Response Statuses

Status Meaning Description Schema
200 OK A collection of recommendation policy objects RecommendationPolicies
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error

Delete a Recommendation Policy

Example Request:


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

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

result = HTTParty.delete('https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/recommendation-policies/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/recommendation-policies/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /recommendation-policies/{recommendationPolicyId}

Deletes a recommendation policy.

Parameters

Parameter In Type Required Default Description Accepted Values
recommendationPolicyId path string true N/A The ID of the recommendation policy. -

Response Statuses

Status Meaning Description Schema
204 No Content The recommendation policy was deleted None
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Update a Recommendation Policy

Example Request:




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

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

result = HTTParty.put('https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/recommendation-policies/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers, body: {"name":"Prior-dx-Cardio-Resp-Failure-Recimmendation","title":"Prior-dx-Cardio-Resp-Failure-Recimmendation","fields":[{"name":"IdentificationStatus","type":"BOOLEAN","value":"true"},{"name":"HierarchicalConditionCategoryNumber","type":"NUMBER","value":"123"}],"conditionIdentificationDefinition":{"id":"49d0677b-28e6-4648-9159-1e114eb7b829","alias":{"system":"LOCAL","value":123}},"tests":[{"field":"IdentificationStatus","operator":"EQ","value":"NEEDS_CURRENT_PERIOD_ATTENTION"}],"messages":[{"format":"TEXT","template":"Prior Dx: This condition was reported previously. If still present, please address clinically and submit appropriate diagnosis code."}],"updatedBy":{"id":"fbc4117a-4f2f-4e39-9d60-76563fa5b83e"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/recommendation-policies/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Prior-dx-Cardio-Resp-Failure-Recimmendation","title":"Prior-dx-Cardio-Resp-Failure-Recimmendation","fields":[{"name":"IdentificationStatus","type":"BOOLEAN","value":"true"},{"name":"HierarchicalConditionCategoryNumber","type":"NUMBER","value":"123"}],"conditionIdentificationDefinition":{"id":"49d0677b-28e6-4648-9159-1e114eb7b829","alias":{"system":"LOCAL","value":123}},"tests":[{"field":"IdentificationStatus","operator":"EQ","value":"NEEDS_CURRENT_PERIOD_ATTENTION"}],"messages":[{"format":"TEXT","template":"Prior Dx: This condition was reported previously. If still present, please address clinically and submit appropriate diagnosis code."}],"updatedBy":{"id":"fbc4117a-4f2f-4e39-9d60-76563fa5b83e"}}

PUT /recommendation-policies/{recommendationPolicyId}

Updates a recommendation policy.

Parameters

Parameter In Type Required Default Description Accepted Values
recommendationPolicyId path string true N/A The ID of the recommendation policy. -
body body putRecommendationPolicies true N/A No description -

Response Statuses

Status Meaning Description Schema
200 OK The recommendation policy was updated RecommendationPolicy
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a Single Recommendation Policy

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/condition-identification/v1/recommendation-policies/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/recommendation-policies/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /recommendation-policies/{recommendationPolicyId}

Retrieves a single recommendation policy.

Parameters

Parameter In Type Required Default Description Accepted Values
recommendationPolicyId path string true N/A The ID of the recommendation policy. -

Response Statuses

Status Meaning Description Schema
200 OK A single recommendation policy RecommendationPolicy
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Suppressions

Suppressions inform the Condition Identification service that identified conditions are no longer applicable for consideration in patient care.

The suppressions include a reason type qualifier that provides context for why the condition is suppressed. If the service identified a condition that never existed and does not currently exist, then the reason type of REJECT is used. If the service identified a condition that did exist but is now resolved, then the reason type of RESOLVE is used.

Create a Suppression for a Patient

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/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/suppressions', headers: headers)

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/suppressions \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json'

POST /pipelines/{pipelineId}/patients/{patientId}/suppressions

Creates a suppression with the provided ID.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The ID of the condition identification pipeline. -
patientId path string true N/A The ID of the patient. -
body body postPipelinesPipelineidPatientsPatientidSuppressions true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created The suppression has been created Suppression
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a List of Suppressions 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-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/suppressions', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/suppressions \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /pipelines/{pipelineId}/patients/{patientId}/suppressions

Retrieves a list of suppressions.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The ID of the condition identification pipeline. -
patientId path string true N/A The ID of the patient. -
type query array[string] false N/A Filters the suppressions by the type of condition identification. By default, all suppressions are returned. -
reasonType query array[string] false N/A Filters the suppressions by the reason type. -
includeExpired query boolean false N/A Filters the suppressions by whether they are expired. If true, then all suppressions are returned. If false, which is the default value, then only nonexpired suppressions are returned. -
orderBy query string false createdAt The field and order by which sorted results are returned. Multiple comma-separated values are interpreted as ANDs. Adding a dash (-) before any supported field returns the suppressions in descending order instead of ascending. The supported fields include createdAt and updatedAt. -
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. -

Response Statuses

Status Meaning Description Schema
200 OK A collection of suppression objects Suppressions
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Delete a Suppression for a Patient

Example Request:


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

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

result = HTTParty.delete('https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/suppressions/f7c59e78-fe8e-4509-90c7-98a4b52a7c01', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/suppressions/f7c59e78-fe8e-4509-90c7-98a4b52a7c01 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /pipelines/{pipelineId}/patients/{patientId}/suppressions/{suppressionId}

Deletes a suppression with the provided ID.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The ID of the condition identification pipeline. -
patientId path string true N/A The ID of the patient. -
suppressionId path string true N/A The ID of the suppression. -

Response Statuses

Status Meaning Description Schema
204 No Content The suppression was deleted None
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Update a Suppression for a Patient

Example Request:




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

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

result = HTTParty.put('https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/suppressions/f7c59e78-fe8e-4509-90c7-98a4b52a7c01', headers: headers)

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/suppressions/f7c59e78-fe8e-4509-90c7-98a4b52a7c01 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json'

PUT /pipelines/{pipelineId}/patients/{patientId}/suppressions/{suppressionId}

Updates a suppression with the provided ID.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The ID of the condition identification pipeline. -
patientId path string true N/A The ID of the patient. -
suppressionId path string true N/A The ID of the suppression. -
body body putPipelinesPipelineidPatientsPatientidSuppressions true N/A No description -

Response Statuses

Status Meaning Description Schema
200 OK The suppression was updated Suppression
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a Single Suppression 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-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/suppressions/206d2277-827b-478e-b543-308e28d74fdc', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/patients/206d2277-827b-478e-b543-308e28d74fdc/suppressions/206d2277-827b-478e-b543-308e28d74fdc \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /pipelines/{pipelineId}/patients/{patientId}/suppressions/{suppressionId}

Retrieves a suppression object by ID.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The ID of the condition identification pipeline. -
patientId path string true N/A The ID of the patient. -
suppressionId path string true N/A The ID of the suppression. -

Response Statuses

Status Meaning Description Schema
200 OK A suppression object Suppression
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Retrieve a List of Suppressions for a Pipeline

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/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/suppressions', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/condition-identification/v1/pipelines/788ddaa0-1e28-4ecc-9945-e87f281b485b/suppressions \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /pipelines/{pipelineId}/suppressions

Retrieves a list of suppressions for a pipeline.

Parameters

Parameter In Type Required Default Description Accepted Values
pipelineId path string true N/A The ID of the condition identification pipeline. -
type query array[string] false N/A Filters the suppressions by the type of condition identification. By default, all suppressions are returned. -
reasonType query array[string] false N/A Filters the suppressions by the reason type. -
includeExpired query boolean false N/A Filters the suppressions by whether they are expired. If true, then all suppressions are returned. If false, which is the default value, then only nonexpired suppressions are returned. -
orderBy query string false createdAt The field and order by which sorted results are returned. Multiple comma-separated values are interpreted as ANDs. Adding a dash (-) before any supported field returns the suppressions in descending order instead of ascending. The supported fields include createdAt and updatedAt. -
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. -

Response Statuses

Status Meaning Description Schema
200 OK A collection of suppression objects Suppressions
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not Found Error

Schema Definitions

postConfigurations

Name Type Required Description Accepted Values
name string true The unique name of the condition identification configuration. -
description string false The description of the condition identification configuration. -
population object true The population ID that identifies the longitudinal records used to process the condition identifications. -
» id string true The ID of the population. -
confidenceWeightIndex object false The confidence weight index structure used to calculate confidence weight values. -
» id string true The ID of the confidence weight index. -
conditionHierarchyIndex object false The condition hierarchy index structure used to determine condition identification trumping. -
» id string true The ID of the condition hierarchy index. -
definitions [object] false The array of condition identification definitions used to process outcomes for patients in the population. -
» id string true The ID of the condition identification definition. -
createdBy object false The individual who entered the configuration into the system. -
» id string true The ID of the individual who entered the configuration into the system. -

Configuration

Name Type Required Description Accepted Values
id string true The ID of the configuration. -
version integer(int32) true The automatically incremented version number of the configuration. -
name string true The unique name of the configuration. -
description string false The description of the configuration. -
population PopulationReference true The population ID that identifies the longitudinal records used to process the condition identifications. -
confidenceWeightIndex ConfidenceWeightIndexReference false The ID of the confidence weight index structure used to calculate confidence weight values. -
conditionHierarchyIndex ConditionHierarchyIndexReference false The ID of the condition hierarchy index structure used to determine condition identification trumping. -
definitions [DefinitionReference] false The condition identification definitions used to process outcomes for patients in the population. -
createdBy PersonnelReference false The ID of the individual who entered the configuration into the system. -
createdAt string true The date and time when the configuration was initially entered into the system. In International Organization for Standardization (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 configuration is first created. Therefore, the field does not need to be set explicitly. -
updatedBy PersonnelReference false The ID of the individual who updated the configuration. -
updatedAt string true The date and time when the configuration was updated in 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 configuration is updated. Therefore, the field does not need to be set explicitly. -

PopulationReference

Name Type Required Description Accepted Values
id string true The population ID. -

ConfidenceWeightIndexReference

Name Type Required Description Accepted Values
id string true The ID of the confidence weight index. -

ConditionHierarchyIndexReference

Name Type Required Description Accepted Values
id string true The ID of the condition hierarchy index. -

DefinitionReference

Name Type Required Description Accepted Values
id string true The ID of the condition identification definition. -
name string false The name of the condition identification definition. -

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. -

Configurations

Name Type Required Description Accepted Values
items [Configuration] 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. -

putConfigurations

Name Type Required Description Accepted Values
name string true The unique name of the condition identification configuration. -
description string false The description of the condition identification configuration. -
population object true The population ID that identifies the longitudinal records used to process the condition identifications. -
» id string true The ID of the population. -
confidenceWeightIndex object false The confidence weight index structure used to calculate confidence weight values. -
» id string true The ID of the confidence weight index. -
conditionHierarchyIndex object false The condition hierarchy index structure used to determine condition identification trumping. -
» id string true The ID of the condition hierarchy index. -
definitions [object] false The array of condition identification definitions used to process outcomes for patients in the population. -
» id string true The ID of the condition identification definition. -
updatedBy object false The individual who updated the configuration in the system. -
» id string true The ID of the individual who updated the configuration in the system. -

postDefinitions

Name Type Required Description Accepted Values
name string true The name of the condition identification definition. -
description string false The description of the condition identification definition. -
messages [object] false The patient reminder narrative descriptions. -
» text string true The patient reminder narrative description. -
catalog string false The catalog of the condition identification definition. -
type string true The type of condition identification definition. PRIOR, SUSPECTED, CLARIFICATION
cohort object false The cohort that is used to refine the list of patients for which this condition identification should apply. -
» id string true The ID of the cohort that is used to refine the list of patients for which this condition identification should apply. -
tags [object] false The colon-delimited combination of the key and value of a tag (for example, Use:Production). This query parameter can be repeated multiple times to query for configurations that contain a combination of more than one tag. When multiple tags are provided, the results include all definitions that have any of the tags. -
» key string true The key associated with the tag. -
» value string true The value associated with the key of a particular tag. -
aliases [object] false The IDs that commonly and uniquely identify the definition and facilitate interoperability among systems. Aliases are distinguished from source IDs that have meaning only in the context of the source system. -
» system string true The authority responsible for assigning the alias value. Alias values are unique within this system namespace but not across systems. -
» value string true The unique ID of the alias in the context of the system or assigning authority. -
components [object] false The components that make up the logic structure of the algorithm that is used to identify conditions. -
» mnemonic string true The mnemonic of the component. -
» category string true The category of the component. PAST_PERIOD, CURRENT_PERIOD, COMPETING, SUPPORTING
createdBy object false The individual who entered the definition into the system. -
» id string true The ID of the individual who entered the definition into the system. -

Definition

Name Type Required Description Accepted Values
id string true The ID of the condition identification definition. -
name string true The name of the condition identification definition. -
description string false The description of the condition identification definition. -
messages [Message] false The patient reminder narrative descriptions. -
catalog string false The catalog of the condition identification definition. -
type string true The type of condition identification definition. PRIOR, SUSPECTED, CLARIFICATION
cohort CohortReference false The cohort that is used to refine the list of patients for which this condition identification should apply. -
tags [Tags] false The colon-delimited combination of the key and value of a tag (for example, Use:Production). This query parameter can be repeated multiple times to query for configurations that contain a combination of more than one tag. When multiple tags are provided, the results include all definitions that have any of the tags. -
aliases [Alias] false The IDs that commonly and uniquely identify the definition and facilitate interoperability among systems. Aliases are distinguished from source IDs, which have meaning only in the context of the source system. -
components [Component] false The components that make up the logic structure of the algorithm that is used to identify conditions. -
createdBy PersonnelReference false The ID of the individual who entered the definition into the system. -
createdAt string true The date and time when the definition 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 definition is first created. Therefore, the field does not need to be set explicitly. -
updatedBy PersonnelReference false The ID of the individual who updated the definition. -
updatedAt string true The date and time when the definition was updated in 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 definition is updated. Therefore, the field does not need to be set explicitly. -

Message

Name Type Required Description Accepted Values
text string true The patient reminder narrative description. -

CohortReference

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

Tags

Name Type Required Description Accepted Values
key string true The key associated with the tag. -
value string true The value of the tag. -

Alias

Name Type Required Description Accepted Values
system string true The authority responsible for assigning the alias value. Alias values are unique within this system namespace but not across systems. -
value string true The unique ID of the alias in the context of the system or assigning authority. -

Component

Name Type Required Description Accepted Values
mnemonic string true The mnemonic of the component. -
category string true The category of the component. PAST_PERIOD, CURRENT_PERIOD, COMPETING, SUPPORTING

Definitions

Name Type Required Description Accepted Values
items [Definition] 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. -

putDefinitions

Name Type Required Description Accepted Values
name string true The name of the condition identification definition. -
description string false The description of the condition identification definition. -
messages [object] false The patient reminder narrative descriptions. -
» text string true The patient reminder narrative description. -
catalog string false The catalog of the condition identification definition. -
type string true The type of condition identification definition. PRIOR, SUSPECTED, CLARIFICATION
cohort object false The cohort that is used to refine the list of patients for which this condition identification should apply. -
» id string true The ID of the cohort that is used to refine the list of patients for which this condition identification should apply. -
tags [object] false The colon-delimited combination of the key and value of a tag (for example, Use:Production). This query parameter can be repeated multiple times to query for configurations that contain a combination of more than one tag. When multiple tags are provided, the results include all definitions that have any of the tags. -
» key string true The key associated with the tag. -
» value string true The value associated with the key of a particular tag. -
aliases [object] false The IDs that commonly and uniquely identify the definition and facilitate interoperability among systems. Aliases are distinguished from source IDs that have meaning only in the context of the source system. -
» system string true The authority responsible for assigning the alias value. Alias values are unique within this system namespace but not across systems. -
» value string true The unique ID of the alias in the context of the system or assigning authority. -
components [object] false The components that make up the logic structure of the algorithm that is used to identify conditions. -
» mnemonic string true The mnemonic of the component. -
» category string true The category of the component. PAST_PERIOD, CURRENT_PERIOD, COMPETING, SUPPORTING
updatedBy object false The individual who updated the definition in the system. -
» id string true The ID of the individual who updated the definition in the system. -

PriorDiagnoses

Name Type Required Description Accepted Values
items [PriorDiagnosis] 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. -

PriorDiagnosis

Name Type Required Description Accepted Values
patient PatientReference true The patient for which the diagnosis is being considered. -
hierarchies Hierarchy false The condition identification hierarchies. -
confidenceWeight ConfidenceWeight false The confidence weight of the condition identification. -
conditionIdentificationDefinition DefinitionReference true The condition identification definition. -
pipeline PipelineReference true The pipeline instance. -
recommendationMessages RecommendationMessages false The key messages and recommendations to guide physicians in the diagnosis based on results from past, current, or potential future exposure and health effects evaluations. -
pastPeriodSupportingData ComponentSupport true The supporting data that indicates a condition was documented in the previous period. -
currentPeriodSupportingData ComponentSupport false The supporting data that indicates a condition was documented in the current period. -
identificationStatus string false Indicates whether the identification status needs attention in the current period. NEEDS_CURRENT_PERIOD_ATTENTION, NO_ACTION

PatientReference

Name Type Required Description Accepted Values
id string true The ID of the associated patient. -
population PopulationReference true The population to which the associated patient belongs. -

Hierarchy

Name Type Required Description Accepted Values
group GroupReference true The reference to the group of condition identification definitions, including the current condition identification, that are ordered in a hierarchy. -
isTrumped boolean true Indicates whether this condition identification was trumped by another item in the same group hierarchy. -
trumpedBy DefinitionReference false All of the condition identification definitions that are present for the patient that represent a higher-order item in the group hierarchy. If this list has one or more items, that indicates that this particular condition identification outcome is considered trumped. -

GroupReference

Name Type Required Description Accepted Values
name string false The name of the referenced group. -

ConfidenceWeight

Name Type Required Description Accepted Values
weight number(float) true The value of the weight. -
weightType string true The type of weight (direct or schedule). DIRECT, SCHEDULE
weightSchedule WeightScheduleReference false The schedule of the confidence weight. -

WeightScheduleReference

Name Type Required Description Accepted Values
name string false The name of the weight schedule. -

PipelineReference

Name Type Required Description Accepted Values
id string true The pipeline ID. -
instanceId string true The pipeline instance ID. -

RecommendationMessages

Name Type Required Description Accepted Values
formatType string true The type of the recommendation message. TEXT, MARKDOWN
message string true The actual recommendation message. -
recommendationPolicy RecommendationPolicyReference false The recommendation policy relevant to the recommended message. -

RecommendationPolicyReference

Name Type Required Description Accepted Values
id string true The ID of the recommendation policy. -
title string true The title of the recommendation policy. -

ComponentSupport

Name Type Required Description Accepted Values
componentMnemonic string true The mnemonic that identifies the condition. -
isSatisfied boolean true Indicates whether the logic of the component is satisfied by this supporting data. -
basis Basis false The basis for identifying the condition. -

Basis

Name Type Required Description Accepted Values
id string true The ID of the referenced resource. -
kind string true The type of the basis that was considered for the identification logic. -

SuspectedDiagnoses

Name Type Required Description Accepted Values
items [SuspectedDiagnosis] 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. -

SuspectedDiagnosis

Name Type Required Description Accepted Values
patient PatientReference true The patient associated with the suspected diagnosis. -
hierarchies Hierarchy false The condition identification hierarchies. -
confidenceWeight ConfidenceWeight false The confidence weight of the condition identification. -
conditionIdentificationDefinition DefinitionReference true The condition identification that the suspected diagnosis is based upon. -
recommendationMessages RecommendationMessages false The key messages and recommendations to guide physicians in the diagnosis based on results from past, current, or potential future exposure and health effects evaluations. -
pipeline PipelineReference true The condition identification pipeline that generated this suspected diagnosis. -
supportingData ComponentSupport false The facts that support the positive identification of the suspected diagnosis. -
competingData ComponentSupport false The facts that dispute the positive identification of the suspected diagnosis. -

DiagnosisClarifications

Name Type Required Description Accepted Values
items [DiagnosisClarification] 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. -

DiagnosisClarification

Name Type Required Description Accepted Values
patient PatientReference true The patient associated with the diagnosis clarification. -
hierarchies Hierarchy false The condition identification hierarchies. -
confidenceWeight ConfidenceWeight false The confidence weight of the condition identification. -
conditionIdentificationDefinition DefinitionReference true The condition identification definition that the diagnosis clarification is based upon. -
recommendationMessages RecommendationMessages false The diagnosis information and recommendations related to the diagnosis clarification. -
pipeline PipelineReference true The condition identification pipeline that generated this diagnosis clarification. -
supportingData ComponentSupport false The facts that support the positive identification of the diagnosis clarification. -

postPipelines

Name Type Required Description Accepted Values
createdBy object false A representation of the individual who entered the pipeline into the system. -
» id string true The unique ID of the individual who entered the pipeline into the system. -
name string true The name of the condition identification pipeline. -
configuration object false The configuration of the condition identification pipeline. -
» id string true The configuration ID of the condition identification pipeline. -
status string false The status of the condition identification pipeline. DRAFT, PUBLISHED, SUSPENDED

Pipeline

Name Type Required Description Accepted Values
id string true The ID of the pipeline. -
instanceId string true The ID of the pipeline instance. -
name string true The name of the pipeline. -
createdAt string true The date and time when the pipeline 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 pipeline is first created. Therefore, the field does not need to be set explicitly. -
createdBy PersonnelReference false The ID of the individual who entered the pipeline into the system. -
configuration ConfigurationReference false The configuration ID of the condition identification pipeline. -
status string true The status of the condition identification pipeline. DRAFT, PUBLISHED, SUSPENDED

ConfigurationReference

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

Pipelines

Name Type Required Description Accepted Values
items [Pipeline] 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. -

postPipelinesPipelineidInstances

Name Type Required Description Accepted Values
createdBy object false A representation of the individual who entered the pipeline into the system. -
» id string true The unique ID of the individual who entered the pipeline into the system. -
name string true The name of the condition identification pipeline. -
configuration object false The configuration of the condition identification pipeline. -
» id string true The configuration ID of the condition identification pipeline. -
status string false The status of the condition identification pipeline. DRAFT, PUBLISHED, SUSPENDED

ConditionIdentificationDefinitionReference

Name Type Required Description Accepted Values
id string true The ID of the condition identification definition. -

User

Name Type Required Description Accepted Values
type string false An enumerated list that describes the role an actor plays in relation to the entity. SYSTEM, PERSONNEL
display string false A textual display that describes the referenced entity. When type is SYSTEM, display is required. -
reference ActorReference false The referenced entity. -

ActorReference

Name Type Required Description Accepted Values
id string true The unique ID of the referenced entity. -

postPipelinesPipelineidPatientsPatientidSuppressions

Name Type Required Description Accepted Values
conditionIdentificationDefinition ConditionIdentificationDefinitionReference true The condition identification definition. -
reasonType string true The suppression reason type. -
expired boolean false Indicates whether the suppression is expired. -
endEffective string false The end date and time when the suppression is no longer effective, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
createdBy User true The actor who created the suppression. -

Suppression

Name Type Required Description Accepted Values
id string true The ID of the suppression. -
patient SuppressionsPatientReference true The patient object. -
pipeline SuppressionsPipelineReference true The pipeline reference object. -
conditionIdentificationDefinition ConditionIdentificationDefinitionReference true The condition identification definition object. -
reasonType string true The type of the suppression reason. REJECT, RESOLVE
endEffective string false The end date and time when the suppression is no longer effective, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
expired boolean false Indicates whether the suppression is expired. -
createdAt string false The date and time when the suppression was initially entered into the system, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
createdBy User false The user who created the suppression. -
updatedAt string false The date and time when the suppression was last modified, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
updatedBy User false The user who last updated the suppression. -

SuppressionsPatientReference

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

SuppressionsPipelineReference

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

Suppressions

Name Type Required Description Accepted Values
items [Suppression] 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. -

putPipelinesPipelineidPatientsPatientidSuppressions

Name Type Required Description Accepted Values
conditionIdentificationDefinition ConditionIdentificationDefinitionReference true The condition identification definition. -
reasonType string true The suppression reason type. -
expired boolean false Indicates whether the suppression is expired. -
endEffective string false The end date and time when the suppression is no longer effective, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
updatedBy User true The actor who updated the suppression. -

postHierarchyIndexes

Name Type Required Description Accepted Values
name string true A hierarchy index name. -
description string false A short description of the hierarchy index. -
groups [object] true No description -
» name string true No description -
» rankedConditionDefinitions [object] true The ranked condition definitions representing the hierarchy. -
»» conditionIdentificationDefinitionId string true No description -
»» ranking integer(int32) true No description -
createdBy string false A universally unique ID (UUID) specifying the creator of the hierarchy index. -

HierarchyIndex

Name Type Required Description Accepted Values
id string true The ID of the hierarchy index. -
name string true The name of the hierarchy index. -
description string false The description of the hierarchy index. -
groups [string] true A collection of condition groups that define a hierarchy of condition identification definitions. -
version string true The version ID of the hierarchy index. -
createdAt string true The date and time when the hierarchy index was created, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
createdBy string false The ID of the person who created the hierarchy index. -
updatedAt string true The date and time when the hierarchy index was updated, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
updatedBy string false The ID of the person who updated the hierarchy index. -

HierarchyIndices

Name Type Required Description Accepted Values
items [HierarchyIndex] 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. -

putHierarchyIndexes

Name Type Required Description Accepted Values
name string true A hierarchy index name. -
description string false A short description of the hierarchy index. -
groups [object] true No description -
» name string true No description -
» rankedConditionDefinitions [object] true The ranked condition definitions representing the hierarchy. -
»» conditionIdentificationDefinitionId string true No description -
»» ranking integer(int32) true No description -
createdBy string false A universally unique ID (UUID) specifying the creator of the hierarchy index. -
updated_by string false A unique ID representing the person who updated the hierarchy index. -

Index

Name Type Required Description Accepted Values
name string true The name of the confidence weight index. -
fields [Fields] false The parameters that can be used to calculate schedule weights. -
directWeights [DirectWeight] false The predefined weights of the condition identification definitions. -
scheduleWeights [ScheduleWeights] false The weights that are based on the scheduled assignments. -

Fields

Name Type Required Description Accepted Values
name string true The unique name of the field in the index. -
dataType string false The data type value that is used to calculate the schedule weight. NUMBER, BOOLEAN, STRING

DirectWeight

Name Type Required Description Accepted Values
conditionIdentificationDefinition ConditionIdentificationDefinitionReference true The condition identification definition that is assigned to the weight. -
weight number(float) true The weight of the condition identification definition. -

ScheduleWeights

Name Type Required Description Accepted Values
name string true The name of the schedule weight. -
conditionIdentificationDefinitions [ConditionIdentificationDefinitionReference] false The condition identification definitions that are assigned to this schedule weight. -
weightFunctions [WeightFunctions] false The functions that are used to evaluate the weight based on the test expression. -

WeightFunctions

Name Type Required Description Accepted Values
tests [Test] false The test evaluations of the expressions to calculate the weight. -
weight number(float) false The numeric weight that is assigned to the condition identification outcome if the test results in a true value. -

Test

Name Type Required Description Accepted Values
field string true The name of a field of the index. The name indicates the data that is considered in this test. -
operator string true

The relational operator that is used to perform the operations on two operands. The following operators are available:

  • EQ: Equal to
  • GTE: Greater than or equal to
  • GT: Greater than
  • LT: Less than
  • LTE: Less than or equal to
  • NEQ: Not equal to
EQ, GTE, GT, LT, LTE, NEQ
value string true The value that is used in the expression evaluation. -

postConfidenceWeightIndexes

Name Type Required Description Accepted Values
name string true The name of the confidence weight index. -
description string false The description of the confidence weight index. -
index Index true The index’s conditional rules to be used to determine the confidence weight score of an individual condition identification outcome. -
createdBy object false The personnel member who created the confidence weight index. -
» id string true The unique ID of the personnel member. -

ConfidenceWeightIndex

Name Type Required Description Accepted Values
id string false The ID of the confidence weight index. -
name string true The unique name of the confidence weight index. -
description string false The weighting of condition identification outcomes that boosts instances of diagnoses that are identified multiple times from a claims source. -
index Index true The index’s conditional rules that are used to determine the confidence weight score of an individual condition identification outcome. -
version integer(int32) true The version of the confidence weight index. -
createdAt string true The date and time when the confidence weight index was created. -
createdBy ConditionIdentificationDefinitionReference false The ID of the personnel member who created the index, if applicable. -
updatedAt string true The date and time when the confidence weight index was updated. -
updatedBy ConditionIdentificationDefinitionReference false The ID of the personnel member who updated the index, if applicable. -

ConfidenceWeightIndices

Name Type Required Description Accepted Values
items [ConfidenceWeightIndex] 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. -

putConfidenceWeightIndexes

Name Type Required Description Accepted Values
name string true The name of the confidence weight index. -
description string false The description of the confidence weight index. -
index Index true The index’s conditional rules to be used to determine the confidence weight score of an individual condition identification outcome. -
updatedBy object false The personnel member who updated the confidence weight index. -
» id string true The unique ID of the personnel member. -

Field

Name Type Required Description Accepted Values
name string true The name of the field. -
type string true The data type of the field. STRING, NUMBER, BOOLEAN
value string true The value of the field. -

ConditionIdDefReference

Name Type Required Description Accepted Values
id string false The ID of the condition identification definition. This ID is required if alias is not specified. -
alias Aliases false No description -

Aliases

Name Type Required Description Accepted Values
system string true The authority responsible for assigning the alias value. Alias values are unique within this system namespace but not across systems. If value is specified, then system is required. -
value string true The unique ID of the provider in the context of the system or assigning authority. If system is specified, then value is required. -

Tests

Name Type Required Description Accepted Values
field string true The covariate to use as the operand for the term calculation. -
operator string true

The relational operator that is used to perform the operations on two operands. The following operators are available:

  • EQ: Equal to
  • GTE: Greater than or equal to
  • GT: Greater than
  • LT: Less than
  • LTE: Less than or equal to
  • NEQ: Not equal to
EQ, GTE, GT, LT, LTE, NEQ
value string true The value for the operand calculation. -

Messages

Name Type Required Description Accepted Values
format string true The format type of the message. TEXT, MARKDOWN
template string true The message template that is used for the variable substitution. The template uses the Mustache web template system. -

postRecommendationPolicies

Name Type Required Description Accepted Values
name string false The internal name of the recommendation policy. -
title string true The title of the recommendation policy. -
fields [Field] false No description -
conditionIdentificationDefinition ConditionIdDefReference true The ID of the condition identification definition. If specified, then alias is optional. -
tests [Tests] false The list of logical expressions to test the given conditions. -
messages [Messages] true No description -
createdBy object false The ID of the individual who entered the recommendation policy into the system. -
» id string true The unique ID of the personnel member. -

RecommendationPolicy

Name Type Required Description Accepted Values
id string false The ID of the recommendation policy. -
name string false The internal name of the recommendation policy. -
title string true The title of the recommendation policy. -
fields [Field] false No description -
conditionIdentificationDefinition ConditionIdDefReference true The list of condition identification definitions usedin this recommendation policy condition. -
tests [Tests] false No description -
messages [Messages] true No description -
createdAt string true The date and time when the recommendation policy was created. In ISO 8601 formatting with precision down to the millisecond (YYYY-MM-DDTHH:mm:ss.sssZ), for example, 2018-02-13T20:41:18.181Z. The time in this field is set automatically when the recommendation policy is first created; therefore, the field does not need to be set explicitly. -
createdBy PersonnelReference false The ID of the personnel within the tenant. -
updatedAt string true The date and time when the recommendation policy was last modified. In ISO 8601 formatting with precision down to the millisecond (YYYY-MM-DDTHH:mm:ss.sssZ), for example, 2018-02-13T20:41:18.181Z. The time in this field is set automatically when the recommendation policy is modified; therefore, the field does not need to be set explicitly. -
updatedBy PersonnelReference false The ID of the personnel within the tenant. -

RecommendationPolicies

Name Type Required Description Accepted Values
items [RecommendationPolicy] 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. -

putRecommendationPolicies

Name Type Required Description Accepted Values
name string false The internal name of the recommendation policy. -
title string true The title of the recommendation policy. -
fields [Field] false The list of fields used in this recommendation policy. -
conditionIdentificationDefinition ConditionIdDefReference true The ID of the condition identification definition. If specified, then alias is optional. -
tests [Tests] false The list of logical expressions to test the given conditions used for qualifying the recommendation policy. -
messages [Messages] true The list of conditional messages available for this recommendation policy. -
updatedBy object false The ID of the individual who updated the recommendation policy in the system. -
» id string true The unique ID of the personnel member. -

ConditionOptions

Name Type Required Description Accepted Values
items [ConditionOption] 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. -

ConditionOption

Name Type Required Description Accepted Values
id string true The ID of the condition option. -
name string true The name of the condition option. -
title string true The user-friendly display name of the condition option. -
conditionIdentificationDefinition ConditionDefinitionIdModel true The condition identification definition that is associated with the condition option. If present, alias is optional. -
default boolean false Indicates that this condition option should be presented as the default selection. -
usage string true The context being used for this condition code. -
codes [Code] true The system representation of the medical code, for example, ICD or SNOMED. -
createdAt string true The date and time when the condition option 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 option is first created. Therefore, the field does not need to be set explicitly. -
createdBy IdModel false The ID of the personnel in the tenant who created the condition option. -
updatedAt string true The date and time when the condition option was updated in 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 option is updated. Therefore, the field does not need to be set explicitly. -
updatedBy IdModel false The ID of the personnel in the tenant who updated the condition option. -

ConditionDefinitionIdModel

Name Type Required Description Accepted Values
id string true The condition identification definition that is associated with the condition option. If present, alias is optional. -

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. -
preferred boolean false The preferred condition code when more than one code is available. -

IdModel

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

postConditionOptions

Name Type Required Description Accepted Values
name string true The unique name of the condition option. -
title string true The user-friendly display name of the condition option. -
usage string true The usage context for the condition option. -
conditionIdentificationDefinition object true The condition identification definition mapped to the condition option. -
» id string false The unique ID of the condition definition. If present, alias is optional. -
» alias object false No description -
»» system string true The authority responsible for assigning the alias value. Alias values are unique within this system namespace but not across systems. -
»» value string true The unique ID of the alias in the context of the system \ or assigning authority. -
default string false The default condition option that belongs to the condition identification definition. -
codes [object] false The code of the condition option. -
» 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. -
» preferred string false The preferred condition code when more than one code is available. -
createdBy object false The individual who entered the condition option into the system. -
» id string false The ID of the individual who entered the condition option into the system. -
aliases [object] false The IDs that commonly and uniquely identify the definition and facilitate interoperability among systems. Aliases are distinguished from source IDs that have meaning only in the context of the source system. -
» system string true The authority responsible for assigning the alias value. Alias values are unique within this system namespace but not across systems. -
» value string true The unique ID of the alias in the context of the system or assigning authority. -
updatedBy object false The individual who updated the condition option in the system. -
» id string true The ID of the individual who updated the condition option in the system. -

putConditionOptions

Name Type Required Description Accepted Values
name string true The unique name of the condition option. -
title string true The user-friendly display name of the condition option. -
usage string true The usage context for the condition option. -
conditionIdentificationDefinition object true The condition identification definition mapped to the condition option. -
» id string false The unique ID of the condition definition. If present, alias is optional. -
» alias object false No description -
»» system string true The authority responsible for assigning the alias value. Alias values are unique within this system namespace but not across systems. -
»» value string true The unique ID of the alias in the context of the system \ or assigning authority. -
default string false The default condition option that belongs to the condition identification definition. -
codes [object] false The code of the condition option. -
» 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. -
» preferred string false The preferred condition code when more than one code is available. -
updatedBy object false The individual who updated the condition option in the system. -
» id string true The ID of the individual who updated the condition option in the system. -