NAV Navbar
Logo cerner
Ruby Shell

Wellness API v1

The HealtheIntent Wellness API enables the defining and management of wellness campaigns, rewards, and personal health assessments.

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

Campaign Configurations

A wellness campaign is an incentive program designed to motivate members to improve their health by completing incentivized activities. A campaign is an organized collection of incentivized activities grouped into categories, subcategories, and groupers. A category can have subcategories, and a subcategory can have groupers. A campaign instance is generated using all the configuration data.

Create a Wellness Campaign

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/wellness/v1/campaign-definitions', headers: headers, body: {"names":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program"}],"descriptions":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program for Consumer Well-Being Campaign."}],"gracePeriodEndsAt":"2020-01-07T00:00:00","startsAt":"2019-01-01T00:00:00Z","endsAt":"2019-12-31T23:59:00Z","reward":{"id":"11e8902c9e2908c69718f13503066bee"},"completionThreshold":1,"adjustmentReward":{"id":"q987462i-9617-4ac5-8601-8054755a9876"},"timeZone":"Central Time (US & Canada)","icon":"campaign_2019_q1.jpg","populations":[{"populationId":"l783179c-0917-4ac5-8601-8054755a2789","dataPartitionId":"o463179c-9618-4ac5-8601-8054755a2890"}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"names":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program"}],"descriptions":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program for Consumer Well-Being Campaign."}],"gracePeriodEndsAt":"2020-01-07T00:00:00","startsAt":"2019-01-01T00:00:00Z","endsAt":"2019-12-31T23:59:00Z","reward":{"id":"11e8902c9e2908c69718f13503066bee"},"completionThreshold":1,"adjustmentReward":{"id":"q987462i-9617-4ac5-8601-8054755a9876"},"timeZone":"Central Time (US & Canada)","icon":"campaign_2019_q1.jpg","populations":[{"populationId":"l783179c-0917-4ac5-8601-8054755a2789","dataPartitionId":"o463179c-9618-4ac5-8601-8054755a2890"}]}

Example response

{
  "id": "m123179c-9617-4ac5-8601-8054755a2123",
  "names": [
    {
      "locale": "en-US",
      "text": "2019 Healthe Living Rewards Program"
    }
  ],
  "descriptions": [
    {
      "locale": "en-US",
      "text": "2019 Healthe Living Rewards Program for Consumer Well-Being Campaign."
    }
  ],
  "categoryId": "l093179c-9617-4ac5-8601-8054755a2098",
  "populations": [
    {
      "populationId": "l783179c-0917-4ac5-8601-8054755a2789",
      "dataPartitionId": "o463179c-9618-4ac5-8601-8054755a2890"
    }
  ],
  "reward": {
    "id": "z123179c-9617-4ac5-8601-8054755a2m12"
  },
  "adjustmentReward": {
    "id": "q987462i-9617-4ac5-8601-8054755a9876"
  },
  "completionThreshold": 1,
  "icon": "campaign_2019_q1.jpg",
  "gracePeriodEndsAt": "2020-01-07T00:00:00",
  "startsAt": "2019-01-01T00:00:00Z",
  "endsAt": "2019-12-31T23:59:00Z",
  "timeZone": "Central Time (US & Canada)",
  "createdAt": "2018-12-15T12:23:12Z",
  "updatedAt": "2018-12-15T12:23:12Z"
}

POST /campaign-definitions

Creates a wellness campaign for a HealtheIntent tenant. This request also creates the parent category so the children categories can be nested.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created CampaignDefinition
400 Bad Request Bad Request. The campaign was not created. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- noDefaultLocale The default locale (en-US) is required for the name if it is used in the body.
- duplicateLocale The locales for the names must be unique.
- missingField Review and complete all required information to continue.
BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden

Retrieve a List of Wellness Campaigns

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

print JSON.pretty_generate(result)


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

Example response

{
  "items": [
    {
      "id": "m123179c-9617-4ac5-8601-8054755a2123",
      "names": [
        {
          "locale": "en-US",
          "text": "2019 Healthe Living Rewards Program"
        }
      ],
      "descriptions": [
        {
          "locale": "en-US",
          "text": "2019 Healthe Living Rewards Program for Consumer Well-Being Campaign."
        }
      ],
      "categoryId": "l093179c-9617-4ac5-8601-8054755a2098",
      "populations": [
        {
          "populationId": "l783179c-0917-4ac5-8601-8054755a2789",
          "dataPartitionId": "o463179c-9618-4ac5-8601-8054755a2890"
        }
      ],
      "reward": {
        "id": "z123179c-9617-4ac5-8601-8054755a2m12"
      },
      "adjustmentReward": {
        "id": "q987462i-9617-4ac5-8601-8054755a9876"
      },
      "completionThreshold": 1,
      "icon": "campaign_2019_q1.jpg",
      "gracePeriodEndsAt": "2020-01-07T00:00:00",
      "startsAt": "2019-01-01T00:00:00Z",
      "endsAt": "2019-12-31T23:59:00Z",
      "timeZone": "Central Time (US & Canada)",
      "createdAt": "2018-12-15T12:23:12Z",
      "updatedAt": "2018-12-15T12:23:12Z"
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions?offset=0&limit=20"
}

GET /campaign-definitions

Retrieves a list of all the available wellness campaigns for a HealtheIntent tenant.

Parameters

Parameter In Type Required Default Description Accepted Values
campaignId query array[string] false N/A Filters by the ID of the campaign. -
status query string false N/A Filters the retrieved campaigns by status. CURRENT, CLOSED
locale query string false N/A A two-letter language and two-letter region ID, for example, en-US. The locale should match the ISO 639-1 specification. See ISO 639 Language Codes on the ISO website for more information. -
name query string false N/A Filters by the name of the campaigns. -
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. startsAt, endsAt, createdAt, updatedAt

Response Statuses

Status Meaning Description Schema
200 OK OK CampaignDefinitions
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden

Delete a Wellness Campaign

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/wellness/v1/campaign-definitions/11e8902c9e2908c69718f13503066bee', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/11e8902c9e2908c69718f13503066bee \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /campaign-definitions/{campaignId}

Deletes a wellness campaign by ID.

Parameters

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

Response Statuses

Status Meaning Description Schema
204 No Content No Content None
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Update a Wellness Campaign

Example Request:




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

headers = {
  'Authorization' => '<auth_header>',
  'Content-Type' => 'application/json',
  'Accept' => 'application/json',
  'If-Match' => {
  "type": "string"
}
} 

result = HTTParty.patch('https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/21e8902c9e2908c69718f13503065be7', headers: headers, body: {"names":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program"}],"descriptions":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program for Consumer Well-Being Campaign."}],"gracePeriodEndsAt":"2020-01-07T00:00:00","startsAt":"2019-01-01T00:00:00Z","endsAt":"2019-12-31T23:59:00Z","reward":{"id":"11e8902c9e2908c69718f13503066bee"},"adjustmentReward":{"id":"q987462i-9617-4ac5-8601-8054755a9876"},"completionThreshold":1,"timeZone":"Central Time (US & Canada)","icon":"campaign_2019_q1.jpg","populations":[{"populationId":"l783179c-0917-4ac5-8601-8054755a2789","dataPartitionId":"o463179c-9618-4ac5-8601-8054755a2890"}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PATCH https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/21e8902c9e2908c69718f13503065be7 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \ \
-H 'If-Match: [object Object]' \
-d {"names":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program"}],"descriptions":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program for Consumer Well-Being Campaign."}],"gracePeriodEndsAt":"2020-01-07T00:00:00","startsAt":"2019-01-01T00:00:00Z","endsAt":"2019-12-31T23:59:00Z","reward":{"id":"11e8902c9e2908c69718f13503066bee"},"adjustmentReward":{"id":"q987462i-9617-4ac5-8601-8054755a9876"},"completionThreshold":1,"timeZone":"Central Time (US & Canada)","icon":"campaign_2019_q1.jpg","populations":[{"populationId":"l783179c-0917-4ac5-8601-8054755a2789","dataPartitionId":"o463179c-9618-4ac5-8601-8054755a2890"}]}

PATCH /campaign-definitions/{campaignId}

Updates a wellness campaign. This is a PATCH request and not a PUT request as many HealtheIntent APIs use, and the updated resource replaces the previous version. See JSON Merge Patch on the Internet Engineering Task Force (IETF) website for more information about PATCH requests.

Parameters

Parameter In Type Required Default Description Accepted Values
If-Match header string true N/A The ETag for a specific version of a resource. If a user or system attempts to update a version of a campaign and the campaign was already updated to a new version, an error occurs. -
campaignId path string true N/A The ID of the campaign. -
body body patchCampaignDefinitions true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content No Content None
400 Bad Request Bad Request. The wellness campaign was not updated. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- noDefaultLocale The default locale (en-US) is required for the name if it is used in the body.
- duplicateLocale The locales for the names must be unique.
- missingField Review and complete all required information to continue.
BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound
409 Conflict Conflict Conflict

Retrieve a Single Wellness Campaign

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/wellness/v1/campaign-definitions/11e8902c9e2908c69718f13503066bee', headers: headers)

print JSON.pretty_generate(result)


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

Example response

{
  "id": "m123179c-9617-4ac5-8601-8054755a2123",
  "names": [
    {
      "locale": "en-US",
      "text": "2019 Healthe Living Rewards Program"
    }
  ],
  "descriptions": [
    {
      "locale": "en-US",
      "text": "2019 Healthe Living Rewards Program for Consumer Well-Being Campaign."
    }
  ],
  "categoryId": "l093179c-9617-4ac5-8601-8054755a2098",
  "populations": [
    {
      "populationId": "l783179c-0917-4ac5-8601-8054755a2789",
      "dataPartitionId": "o463179c-9618-4ac5-8601-8054755a2890"
    }
  ],
  "reward": {
    "id": "z123179c-9617-4ac5-8601-8054755a2m12"
  },
  "adjustmentReward": {
    "id": "q987462i-9617-4ac5-8601-8054755a9876"
  },
  "completionThreshold": 1,
  "icon": "campaign_2019_q1.jpg",
  "gracePeriodEndsAt": "2020-01-07T00:00:00",
  "startsAt": "2019-01-01T00:00:00Z",
  "endsAt": "2019-12-31T23:59:00Z",
  "timeZone": "Central Time (US & Canada)",
  "createdAt": "2018-12-15T12:23:12Z",
  "updatedAt": "2018-12-15T12:23:12Z"
}

GET /campaign-definitions/{campaignId}

Retrieves a single wellness campaign for a HealtheIntent tenant by ID.

Parameters

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

Response Statuses

Status Meaning Description Schema
200 OK OK CampaignDefinition
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Response Headers

Status Header Type Format Description
200 ETag string The ETag of a specific version of the campaign.

Create a Category for a Campaign

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/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions', headers: headers, body: {"names":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program."}],"descriptions":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program for Well-Being Campaign."}],"startsAt":"2019-01-01T00:00:00","endsAt":"2019-12-31T23:00:00","parentCategoryId":"77a233a3-54d4-4ad3-9e63-53bb71762290","icon":"category.jpg","reward":{"id":"11b111c4-54d4-4ad3-9e63-53bb71762290"},"completionThreshold":1,"adjustmentReward":{"id":"22c222d5-54d4-4ad3-9e63-53bb71762290"},"objectives":[{"id":"a23222d5-23d4-ftd3-9e63-53bb71762290"},{"id":"62cd2e7c-8d39-11e9-bc42-526af7764f64"}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"names":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program."}],"descriptions":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program for Well-Being Campaign."}],"startsAt":"2019-01-01T00:00:00","endsAt":"2019-12-31T23:00:00","parentCategoryId":"77a233a3-54d4-4ad3-9e63-53bb71762290","icon":"category.jpg","reward":{"id":"11b111c4-54d4-4ad3-9e63-53bb71762290"},"completionThreshold":1,"adjustmentReward":{"id":"22c222d5-54d4-4ad3-9e63-53bb71762290"},"objectives":[{"id":"a23222d5-23d4-ftd3-9e63-53bb71762290"},{"id":"62cd2e7c-8d39-11e9-bc42-526af7764f64"}]}

Example response

{
  "id": "qwe3179c-9617-4ac5-8601-8054755a2a5c",
  "parentCategoryId": "b923179c-9617-6nc5-8601-8054755a1789",
  "position": 2,
  "names": [
    {
      "locale": "en-US",
      "text": "Reduce My Premium"
    }
  ],
  "descriptions": [
    {
      "locale": "en-US",
      "text": "Activities that help reduce your premium."
    }
  ],
  "reward": {
    "id": "b123werc-9617-4ac5-8601-8054755aabcd"
  },
  "adjustmentReward": {
    "id": "q113123i-9617-4ac5-8601-8054755a9876"
  },
  "completionThreshold": 1,
  "icon": "cat1.jep",
  "startsAt": "2019-01-01T00:00:00Z",
  "endsAt": "2019-12-31T23:59:00Z",
  "objectives": [
    {
      "position": 1,
      "objectiveDefinitionId": "a023179c-9617-4ac5-8601-8054755a2a5c"
    }
  ],
  "categories": [
    {}
  ],
  "createdAt": "2018-12-15T12:23:12Z",
  "updatedAt": "2018-12-15T12:23:12Z"
}

POST /campaign-definitions/{campaignId}/category-definitions

Creates a category for a campaign. Categories can be nested up to three levels.

Parameters

Parameter In Type Required Default Description Accepted Values
campaignId path string true N/A The ID of the wellness campaign. -
body body postCampaignDefinitionsCampaignidCategoryDefinitions true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created Created CampaignCategoryDefinition
400 Bad Request Bad Request. The category was not created. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- noDefaultLocale The default locale (en-US) is required for the name if it is used in the body.
- duplicateLocale The locales for the names must be unique.
- missingField Review and complete all required information to continue.
BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Retrieve a List of Categories for a Campaign

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/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "qwe3179c-9617-4ac5-8601-8054755a2a5c",
      "parentCategoryId": "b923179c-9617-6nc5-8601-8054755a1789",
      "position": 2,
      "names": [
        {
          "locale": "en-US",
          "text": "Reduce My Premium"
        }
      ],
      "descriptions": [
        {
          "locale": "en-US",
          "text": "Activities that help reduce your premium."
        }
      ],
      "reward": {
        "id": "b123werc-9617-4ac5-8601-8054755aabcd"
      },
      "adjustmentReward": {
        "id": "q113123i-9617-4ac5-8601-8054755a9876"
      },
      "completionThreshold": 1,
      "icon": "cat1.jep",
      "startsAt": "2019-01-01T00:00:00Z",
      "endsAt": "2019-12-31T23:59:00Z",
      "objectives": [
        {
          "position": 1,
          "objectiveDefinitionId": "a023179c-9617-4ac5-8601-8054755a2a5c"
        }
      ],
      "categories": [
        {}
      ],
      "createdAt": "2018-12-15T12:23:12Z",
      "updatedAt": "2018-12-15T12:23:12Z"
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness-campaign/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness-campaign/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions?offset=0&limit=20"
}

GET /campaign-definitions/{campaignId}/category-definitions

Retrieves a list of categories for a campaign.

Parameters

Parameter In Type Required Default Description Accepted Values
campaignId path string true N/A The ID of the wellness campaign. -
locale query string false N/A Filters by locale. A locale is a two-letter language and two-letter region ID, for example, en-US. If this parameter is not specified, the default en-US locale is used. -
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 OK CampaignCategoryDefinitions
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden

Update a Category

Example Request:




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

headers = {
  'Authorization' => '<auth_header>',
  'Content-Type' => 'application/json',
  'Accept' => 'application/json',
  'If-Match' => {
  "type": "string"
}
} 

result = HTTParty.patch('https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions/e933c828-d656-48a7-a875-01467419ed72', headers: headers, body: {"names":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program."}],"descriptions":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program for Well-Being Campaign."}],"startsAt":"2019-01-01T00:00:00","endsAt":"2019-12-31T23:00:00","parentCategoryId":"77a233a3-54d4-4ad3-9e63-53bb71762290","position":2,"icon":"category.jpg","reward":{"id":"11b111c4-54d4-4ad3-9e63-53bb71762290"},"completionThreshold":1,"adjustmentReward":{"id":"22c222d5-54d4-4ad3-9e63-53bb71762290"},"objectives":[{"id":"a23222d5-23d4-ftd3-9e63-53bb71762290"},{"id":"62cd2e7c-8d39-11e9-bc42-526af7764f64"}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PATCH https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions/e933c828-d656-48a7-a875-01467419ed72 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \ \
-H 'If-Match: [object Object]' \
-d {"names":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program."}],"descriptions":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program for Well-Being Campaign."}],"startsAt":"2019-01-01T00:00:00","endsAt":"2019-12-31T23:00:00","parentCategoryId":"77a233a3-54d4-4ad3-9e63-53bb71762290","position":2,"icon":"category.jpg","reward":{"id":"11b111c4-54d4-4ad3-9e63-53bb71762290"},"completionThreshold":1,"adjustmentReward":{"id":"22c222d5-54d4-4ad3-9e63-53bb71762290"},"objectives":[{"id":"a23222d5-23d4-ftd3-9e63-53bb71762290"},{"id":"62cd2e7c-8d39-11e9-bc42-526af7764f64"}]}

PATCH /campaign-definitions/{campaignId}/category-definitions/{categoryId}

Updates a category.

Parameters

Parameter In Type Required Default Description Accepted Values
If-Match header string true N/A The ETag for a specific version of a resource. If a user or system attempts to update a version of a category and the category was already updated to a new version, an error occurs. -
campaignId path string true N/A The ID of the wellness campaign. -
categoryId path string true N/A The ID of the category. -
body body patchCampaignDefinitionsCampaignidCategoryDefinitions true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content No Content None
400 Bad Request Bad Request. The category was not created. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- noDefaultLocale The default locale (en-US) is required for the name if it is used in the body.
- duplicateLocale The locales for the names must be unique.
- missingField Review and complete all required information to continue.
BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Delete a Category From a Campaign

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/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions/e933c828-d656-48a7-a875-01467419ed72', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions/e933c828-d656-48a7-a875-01467419ed72 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /campaign-definitions/{campaignId}/category-definitions/{categoryId}

Removes a category or category ID from a campaign.

Parameters

Parameter In Type Required Default Description Accepted Values
campaignId path string true N/A The ID of the wellness campaign. -
categoryId path string true N/A The ID of the category. -

Response Statuses

Status Meaning Description Schema
204 No Content No Content None
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Create an Objective or Goal for a Category

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/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions/e933c828-d656-48a7-a875-01467419ed72/objective-definitions', headers: headers, body: {"titles":[{"locale":"en-US","text":"Annual Flu Vaccination"}],"descriptions":[{"locale":"en-US","text":"Receive your annual flu vaccination and earn 25 points."}],"sourceDefinition":{"id":"z123179c-9617-4ac5-8601-8054755a2456","kind":"QUESTIONNAIRE"},"frequency":"DAILY","isRepeatableWithinFrequency":true,"startsAt":"2019-01-01T00:00:00","endsAt":"2019-12-31T23:00:00","maxCompletionCount":10,"primaryObjectiveId":"37a233a3-54d4-4ad3-9e63-53bb71762290","sources":"[ SPECIFIC_PROVIDER, CLAIM, SELF_ENTERED, APP_DEVICE, COACH_ENTERED, ADMINISTRATOR_UPLOADED, EMR_DW_INTEGRATION ]","conditions":[{"value":"50","operator":">","target":100,"subtype":"SYSTOLIC","consumerConditionType":"AGE"}],"codings":[{"referenceId":"26bed4ce-65f7-4cb8-9562-a055cdcf4f15|EXERCISE_OBSTYPE","kind":"ontology#concept"}],"reward":{"id":"11b111c4-54d4-4ad3-9e63-53bb71762290","limitPerFrequency":1}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions/e933c828-d656-48a7-a875-01467419ed72/objective-definitions \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"titles":[{"locale":"en-US","text":"Annual Flu Vaccination"}],"descriptions":[{"locale":"en-US","text":"Receive your annual flu vaccination and earn 25 points."}],"sourceDefinition":{"id":"z123179c-9617-4ac5-8601-8054755a2456","kind":"QUESTIONNAIRE"},"frequency":"DAILY","isRepeatableWithinFrequency":true,"startsAt":"2019-01-01T00:00:00","endsAt":"2019-12-31T23:00:00","maxCompletionCount":10,"primaryObjectiveId":"37a233a3-54d4-4ad3-9e63-53bb71762290","sources":"[ SPECIFIC_PROVIDER, CLAIM, SELF_ENTERED, APP_DEVICE, COACH_ENTERED, ADMINISTRATOR_UPLOADED, EMR_DW_INTEGRATION ]","conditions":[{"value":"50","operator":">","target":100,"subtype":"SYSTOLIC","consumerConditionType":"AGE"}],"codings":[{"referenceId":"26bed4ce-65f7-4cb8-9562-a055cdcf4f15|EXERCISE_OBSTYPE","kind":"ontology#concept"}],"reward":{"id":"11b111c4-54d4-4ad3-9e63-53bb71762290","limitPerFrequency":1}}

Example response

{
  "id": "c44718e2-623f-4202-a4bb-db3e5816d258",
  "position": 1,
  "titles": [
    {
      "locale": "en-US",
      "text": "Complete the PHA"
    }
  ],
  "descriptions": [
    {
      "locale": "en-US",
      "text": "Complete the personal health assessment (PHA) to earn 100 points."
    }
  ],
  "sourceDefinition": {
    "id": "abc3179c-9617-4ac5-8601-8054755a2xyz",
    "kind": "wellness#healthyHabit"
  },
  "frequency": "DAILY",
  "startsAt": "2019-01-01T00:00:00Z",
  "endsAt": "2019-12-31T23:59:00Z",
  "maxCompletionCount": 10,
  "primaryObjectiveId": "x123456q-9617-4ac5-8601-80547512345",
  "alternatives": [
    {}
  ],
  "conditions": [
    {
      "value": 100,
      "operator": ">",
      "target": 100,
      "consumerConditionType": "AGE",
      "subtype": "SYSTOLIC"
    }
  ],
  "sources": [
    "SPECIFIC_PROVIDER",
    "CLAIM",
    "SELF_ENTERED",
    "APP_DEVICE",
    "COACH_ENTERED"
  ],
  "codings": [
    {
      "referenceId": "26bed4ce-65f7-4cb8-9562-a055cdcf4f15|EXERCISE_OBSTYPE",
      "kind": "ontology#concept"
    }
  ],
  "reward": {
    "id": "11b111c4-54d4-4ad3-9e63-53bb71762290",
    "limitPerFrequency": 1
  },
  "createdAt": "2018-12-15T12:23:12Z",
  "updatedAt": "2018-12-15T12:23:12Z"
}

POST /campaign-definitions/{campaignId}/category-definitions/{categoryId}/objective-definitions

Creates an objective or goal for a category of a wellness campaign.

Parameters

Parameter In Type Required Default Description Accepted Values
campaignId path string true N/A The ID of the wellness campaign. -
categoryId path string true N/A The ID of the category. -
body body postCampaignDefinitionsCampaignidCategoryDefinitionsCategoryidObjectiveDefinitions true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created Created Objective
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Retrieve a List of Objectives or Goals for a Category

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/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions/e933c828-d656-48a7-a875-01467419ed72/objective-definitions', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions/e933c828-d656-48a7-a875-01467419ed72/objective-definitions \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "c44718e2-623f-4202-a4bb-db3e5816d258",
      "position": 1,
      "titles": [
        {
          "locale": "en-US",
          "text": "Complete the PHA"
        }
      ],
      "descriptions": [
        {
          "locale": "en-US",
          "text": "Complete the personal health assessment (PHA) to earn 100 points."
        }
      ],
      "sourceDefinition": {
        "id": "abc3179c-9617-4ac5-8601-8054755a2xyz",
        "kind": "wellness#healthyHabit"
      },
      "frequency": "DAILY",
      "startsAt": "2019-01-01T00:00:00Z",
      "endsAt": "2019-12-31T23:59:00Z",
      "maxCompletionCount": 10,
      "primaryObjectiveId": "x123456q-9617-4ac5-8601-80547512345",
      "alternatives": [
        {}
      ],
      "conditions": [
        {
          "value": 100,
          "operator": ">",
          "target": 100,
          "consumerConditionType": "AGE",
          "subtype": "SYSTOLIC"
        }
      ],
      "sources": [
        "SPECIFIC_PROVIDER",
        "CLAIM",
        "SELF_ENTERED",
        "APP_DEVICE",
        "COACH_ENTERED"
      ],
      "codings": [
        {
          "referenceId": "26bed4ce-65f7-4cb8-9562-a055cdcf4f15|EXERCISE_OBSTYPE",
          "kind": "ontology#concept"
        }
      ],
      "reward": {
        "id": "11b111c4-54d4-4ad3-9e63-53bb71762290",
        "limitPerFrequency": 1
      },
      "createdAt": "2018-12-15T12:23:12Z",
      "updatedAt": "2018-12-15T12:23:12Z"
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions/e933c828-d656-48a7-a875-01467419ed72/objective-definitions?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions/e933c828-d656-48a7-a875-01467419ed72/objective-definitions?offset=0&limit=20"
}

GET /campaign-definitions/{campaignId}/category-definitions/{categoryId}/objective-definitions

Retrieves a list of objectives or goals for a category of a wellness campaign.

Parameters

Parameter In Type Required Default Description Accepted Values
campaignId path string true N/A The ID of the wellness campaign. -
categoryId path string true N/A The ID of the category. -
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. updatedAt, -updatedAt

Response Statuses

Status Meaning Description Schema
200 OK OK Objectives
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Delete an Objective Definition From a Category

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/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions/e933c828-d656-48a7-a875-01467419ed72/objective-definitions/3d17b72e-02e5-40b0-ab9b-35530a2c39cc', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions/e933c828-d656-48a7-a875-01467419ed72/objective-definitions/3d17b72e-02e5-40b0-ab9b-35530a2c39cc \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /campaign-definitions/{campaignId}/category-definitions/{categoryId}/objective-definitions/{objectiveDefinitionId}

Deletes an objective definition from a category of a wellness campaign.

Parameters

Parameter In Type Required Default Description Accepted Values
campaignId path string true N/A The ID of the wellness campaign. -
categoryId path string true N/A The ID of the category. -
objectiveDefinitionId path string true N/A The ID of the objective. -

Response Statuses

Status Meaning Description Schema
204 No Content No Content None
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Update an Objective in a Category

Example Request:




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

headers = {
  'Authorization' => '<auth_header>',
  'Content-Type' => 'application/json',
  'Accept' => 'application/json',
  'If-Match' => {
  "type": "string"
}
} 

result = HTTParty.patch('https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions/e933c828-d656-48a7-a875-01467419ed72/objective-definitions/3d17b72e-02e5-40b0-ab9b-35530a2c39cc', headers: headers, body: {"titles":[{"locale":"en-US","text":"Annual Flu Vaccination."}],"descriptions":[{"locale":"en-US","text":"Receive your annual flu vaccination and earn 25 points."}],"sourceDefinition":{"id":"z123179c-9617-4ac5-8601-8054755a2456","kind":"QUESTIONNAIRE"},"frequency":"DAILY","isRepeatableWithinFrequency":true,"startsAt":"2019-01-01T00:00:00","endsAt":"2019-12-31T23:00:00","maxCompletionCount":10,"sources":"[ SPECIFIC_PROVIDER, CLAIM ]","conditions":[{"value":"50","operator":">","target":100,"subtype":"SYSTOLIC","consumerConditionType":"AGE"}],"codings":[{"referenceId":"26bed4ce-65f7-4cb8-9562-a055cdcf4f15|EXERCISE_OBSTYPE","kind":"ontology#concept"}],"reward":{"id":"11b111c4-54d4-4ad3-9e63-53bb71762290","limitPerFrequency":1}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PATCH https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-definitions/1233179c-9617-4ac5-8601-8054755a2asd/category-definitions/e933c828-d656-48a7-a875-01467419ed72/objective-definitions/3d17b72e-02e5-40b0-ab9b-35530a2c39cc \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \ \
-H 'If-Match: [object Object]' \
-d {"titles":[{"locale":"en-US","text":"Annual Flu Vaccination."}],"descriptions":[{"locale":"en-US","text":"Receive your annual flu vaccination and earn 25 points."}],"sourceDefinition":{"id":"z123179c-9617-4ac5-8601-8054755a2456","kind":"QUESTIONNAIRE"},"frequency":"DAILY","isRepeatableWithinFrequency":true,"startsAt":"2019-01-01T00:00:00","endsAt":"2019-12-31T23:00:00","maxCompletionCount":10,"sources":"[ SPECIFIC_PROVIDER, CLAIM ]","conditions":[{"value":"50","operator":">","target":100,"subtype":"SYSTOLIC","consumerConditionType":"AGE"}],"codings":[{"referenceId":"26bed4ce-65f7-4cb8-9562-a055cdcf4f15|EXERCISE_OBSTYPE","kind":"ontology#concept"}],"reward":{"id":"11b111c4-54d4-4ad3-9e63-53bb71762290","limitPerFrequency":1}}

PATCH /campaign-definitions/{campaignId}/category-definitions/{categoryId}/objective-definitions/{objectiveDefinitionId}

Updates an objective or goal in a category of a wellness campaign.

Parameters

Parameter In Type Required Default Description Accepted Values
If-Match header string true N/A The ETag for a specific version of a resource. If a user or system attempts to update a version of an objective and the objective was already updated to a new version, an error occurs. -
campaignId path string true N/A The ID of the wellness campaign. -
categoryId path string true N/A The ID of the category. -
objectiveDefinitionId path string true N/A The ID of the objective. -
body body patchCampaignDefinitionsCampaignidCategoryDefinitionsCategoryidObjectiveDefinitions true N/A No description -

Response Statuses

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

Create a New Campaign Using a Published Campaign

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/wellness/v1/campaigns', headers: headers, body: {"templateCampaignId":"m123179c-9617-4ac5-8601-8054755a2123","names":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program"}],"descriptions":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program for Consumer Well-Being Campaign."}],"gracePeriodEndsAt":"2020-01-07T00:00:00","startsAt":"2019-01-01T00:00:00Z","endsAt":"2019-12-31T23:59:00Z"}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaigns \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"templateCampaignId":"m123179c-9617-4ac5-8601-8054755a2123","names":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program"}],"descriptions":[{"locale":"en-US","text":"2019 Healthe Living Rewards Program for Consumer Well-Being Campaign."}],"gracePeriodEndsAt":"2020-01-07T00:00:00","startsAt":"2019-01-01T00:00:00Z","endsAt":"2019-12-31T23:59:00Z"}

Example response

{
  "campaignId": "q093179c-9617-4ac5-8601-8054755a2123"
}

POST /campaigns

Creates a new campaign and its related categories, objectives, and rewards using a campaign instance as a template. When this request is sent, the following operations occur:

  1. The campaign instance is retrieved based on the specified template campaign ID.
  2. The campaign instance’s categories, objectives, and rewards are retrieved and used to create a new set of those entities associated with the newly created campaign definition.
  3. If a name, description, startsAt, endsAt, or gracePeriodEndsAt parameter is specified in the request, the values are used for the new campaign definition.
The new campaign is not published as a campaign instance until a request is sent to the Publish a Campaign endpoint.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created Campaign
400 Bad Request Bad Request. The campaign was not copied. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- missingField Review and complete all required information to continue.
BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Retrieve a List of Campaign 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/wellness/v1/campaign-instances', headers: headers)

print JSON.pretty_generate(result)


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

Example response

{
  "items": [
    {
      "id": "a12141b0-2cb3-44be-9f4f-0eef101c309d",
      "campaignId": "q093179c-9617-4ac5-8601-8054755a2123",
      "categoryId": "8d805c5a-3090-4aed-b5bf-52737594fa39",
      "names": [
        {
          "locale": "en-US",
          "text": "2019 Healthe Living Rewards Program"
        }
      ],
      "descriptions": [
        {
          "locale": "en-US",
          "text": "2019 Healthe Living Rewards Program for Consumer Well-Being Campaign."
        }
      ],
      "completionThreshold": 1,
      "startsAt": "2019-01-01T00:00:00Z",
      "endsAt": "2019-12-31T23:59:00Z",
      "gracePeriodEndsAt": "2019-12-31T23:59:00Z",
      "reward": {
        "id": "11e8902c9e2908c69718f13503066bee",
        "value": "1",
        "limit": "10",
        "units": [
          {
            "singularName": "dollar",
            "pluralName": "dollars",
            "locale": "en-US"
          }
        ]
      },
      "adjustmentReward": {
        "id": "11e8902c9e2908c69718f13503066bee",
        "value": "1",
        "limit": "10",
        "units": [
          {
            "singularName": "dollar",
            "pluralName": "dollars",
            "locale": "en-US"
          }
        ]
      },
      "timeZone": "Central Time (US & Canada)",
      "icon": "campaign_2019_q1.jpg",
      "populations": [
        {
          "populationId": "l783179c-0917-4ac5-8601-8054755a2789",
          "dataPartitionId": "o463179c-9618-4ac5-8601-8054755a2890"
        }
      ],
      "createdAt": "2018-12-15T12:23:12Z",
      "updatedAt": "2018-12-15T12:23:12Z",
      "categories": [
        {
          "id": "b923179c-9617-4ac5-8601-8054755a2234",
          "parentCategoryId": "a123179c-9633-4ac5-8601-8054755a2a5c",
          "names": [
            {
              "locale": "en-US",
              "text": "2019 Healthe Living Rewards Program"
            }
          ],
          "descriptions": [
            {
              "locale": "en-US",
              "text": "2019 Healthe Living Rewards Program for Consumer Well-Being Campaign."
            }
          ],
          "reward": {
            "id": "11e8902c9e2908c69718f13503066bee",
            "value": "1",
            "limit": "10",
            "units": [
              {
                "singularName": "dollar",
                "pluralName": "dollars",
                "locale": "en-US"
              }
            ]
          },
          "adjustmentReward": {
            "id": "11e8902c9e2908c69718f13503066bee",
            "value": "1",
            "limit": "10",
            "units": [
              {
                "singularName": "dollar",
                "pluralName": "dollars",
                "locale": "en-US"
              }
            ]
          },
          "completionThreshold": 1,
          "icon": "category_2019_q1.jpg",
          "startsAt": "2019-01-01T00:00:00Z",
          "endsAt": "2019-12-31T23:59:00Z",
          "createdAt": "2018-12-15T12:23:12Z",
          "updatedAt": "2018-12-15T12:23:12Z",
          "objectives": [
            {
              "id": "c44718e2-623f-4202-a4bb-db3e5816d258",
              "activity_definition_id": "a66718e2-532d-2232-b6rt-dfe24343234",
              "position": 1,
              "titles": [
                {
                  "locale": "en-US",
                  "text": "Complete the PHA"
                }
              ],
              "descriptions": [
                {
                  "locale": "en-US",
                  "text": "Complete the personal health assessment (PHA) to earn 100 points."
                }
              ],
              "startsAt": "2019-01-01T00:00:00Z",
              "endsAt": "2019-12-31T23:59:00Z",
              "sourceDefinition": {
                "id": "c923179c-9617-4ac5-8601-8054755a2a5c",
                "kind": "wellness#healthyHabit"
              },
              "frequency": "QUARTERLY",
              "maxCompletionCount": 10,
              "primaryObjectiveId": "x123456q-9617-4ac5-8601-80547512345",
              "alternatives": [
                {}
              ],
              "conditions": [
                {
                  "value": 100,
                  "operator": ">",
                  "target": 100,
                  "consumerConditionType": "AGE",
                  "subtype": "SYSTOLIC"
                }
              ],
              "codings": [
                {
                  "referenceId": "26bed4ce-65f7-4cb8-9562-a055cdcf4f15|EXERCISE_OBSTYPE",
                  "kind": "ontology#concept"
                }
              ],
              "sources": [
                "SELF_ENTERED"
              ],
              "incentive": {
                "id": "20556922-21e0-46dc-9224-7b914bb67b5d",
                "objectiveId": "12356922-21e0-46dc-9224-7b914bb67b5d",
                "rewardLimitPerFrequency": 5,
                "reward": {
                  "id": "11e8902c9e2908c69718f13503066bee",
                  "value": "1",
                  "limit": "10",
                  "units": [
                    {
                      "singularName": "dollar",
                      "pluralName": "dollars",
                      "locale": "en-US"
                    }
                  ]
                }
              }
            }
          ],
          "categories": [
            {}
          ]
        }
      ],
      "objectives": [
        {
          "id": "c44718e2-623f-4202-a4bb-db3e5816d258",
          "activity_definition_id": "a66718e2-532d-2232-b6rt-dfe24343234",
          "position": 1,
          "titles": [
            {
              "locale": "en-US",
              "text": "Complete the PHA"
            }
          ],
          "descriptions": [
            {
              "locale": "en-US",
              "text": "Complete the personal health assessment (PHA) to earn 100 points."
            }
          ],
          "startsAt": "2019-01-01T00:00:00Z",
          "endsAt": "2019-12-31T23:59:00Z",
          "sourceDefinition": {
            "id": "c923179c-9617-4ac5-8601-8054755a2a5c",
            "kind": "wellness#healthyHabit"
          },
          "frequency": "QUARTERLY",
          "maxCompletionCount": 10,
          "primaryObjectiveId": "x123456q-9617-4ac5-8601-80547512345",
          "alternatives": [
            {}
          ],
          "conditions": [
            {
              "value": 100,
              "operator": ">",
              "target": 100,
              "consumerConditionType": "AGE",
              "subtype": "SYSTOLIC"
            }
          ],
          "codings": [
            {
              "referenceId": "26bed4ce-65f7-4cb8-9562-a055cdcf4f15|EXERCISE_OBSTYPE",
              "kind": "ontology#concept"
            }
          ],
          "sources": [
            "SELF_ENTERED"
          ],
          "incentive": {
            "id": "20556922-21e0-46dc-9224-7b914bb67b5d",
            "objectiveId": "12356922-21e0-46dc-9224-7b914bb67b5d",
            "rewardLimitPerFrequency": 5,
            "reward": {
              "id": "11e8902c9e2908c69718f13503066bee",
              "value": "1",
              "limit": "10",
              "units": [
                {
                  "singularName": "dollar",
                  "pluralName": "dollars",
                  "locale": "en-US"
                }
              ]
            }
          }
        }
      ]
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness-campaign/v1/campaign-instances?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness-campaign/v1/campaign-instances?offset=0&limit=20"
}

GET /campaign-instances

Retrieves a list of campaign instances.

Parameters

Parameter In Type Required Default Description Accepted Values
campaignId query string false N/A Filters by the ID of a campaign. -
objectiveId query string false N/A Filters by the ID of an objective. -
incentiveId query string false N/A Filters by the ID of an incentive. -
rewardId query string false N/A Filters by the ID of a reward. -
status query string false N/A Filters the retrieved campaign instances by status. A status of CURRENT indicates that the current date is between the start and end dates of the campaign instance. CURRENT
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 OK CampaignInstances
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden

Publish a Campaign

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/wellness/v1/campaign-instances', headers: headers, body: {"campaignId":"m123179c-9617-4ac5-8601-8054755a2123"}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-instances \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"campaignId":"m123179c-9617-4ac5-8601-8054755a2123"}

POST /campaign-instances

Publishes a campaign with the specified ID. A published campaign is available to members.

Parameters

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

Response Statuses

Status Meaning Description Schema
204 No Content No Content None
400 Bad Request Bad Request. The campaign was not published. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- errorCreateReference The reference could not be created.
- categoryDate Category dates must be within the parent category dates.
- objectiveNotFound The category’s objective or objective cannot be found.
- incentiveNotFound The category’s incentive or incentives cannot be found.
- rewardNotFound The category’s reward cannot be found.
- translationNotFound The category’s translations cannot be found.
- objectiveDate Objective dates must be within the category dates.
BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden

Retrieve a Single Campaign 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/wellness/v1/campaign-instances/11e8902c9e2908c69718f13503066bee', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-instances/11e8902c9e2908c69718f13503066bee \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "a12141b0-2cb3-44be-9f4f-0eef101c309d",
  "campaignId": "q093179c-9617-4ac5-8601-8054755a2123",
  "categoryId": "8d805c5a-3090-4aed-b5bf-52737594fa39",
  "names": [
    {
      "locale": "en-US",
      "text": "2019 Healthe Living Rewards Program"
    }
  ],
  "descriptions": [
    {
      "locale": "en-US",
      "text": "2019 Healthe Living Rewards Program for Consumer Well-Being Campaign."
    }
  ],
  "completionThreshold": 1,
  "startsAt": "2019-01-01T00:00:00Z",
  "endsAt": "2019-12-31T23:59:00Z",
  "gracePeriodEndsAt": "2019-12-31T23:59:00Z",
  "reward": {
    "id": "11e8902c9e2908c69718f13503066bee",
    "value": "1",
    "limit": "10",
    "units": [
      {
        "singularName": "dollar",
        "pluralName": "dollars",
        "locale": "en-US"
      }
    ]
  },
  "adjustmentReward": {
    "id": "11e8902c9e2908c69718f13503066bee",
    "value": "1",
    "limit": "10",
    "units": [
      {
        "singularName": "dollar",
        "pluralName": "dollars",
        "locale": "en-US"
      }
    ]
  },
  "timeZone": "Central Time (US & Canada)",
  "icon": "campaign_2019_q1.jpg",
  "populations": [
    {
      "populationId": "l783179c-0917-4ac5-8601-8054755a2789",
      "dataPartitionId": "o463179c-9618-4ac5-8601-8054755a2890"
    }
  ],
  "createdAt": "2018-12-15T12:23:12Z",
  "updatedAt": "2018-12-15T12:23:12Z",
  "categories": [
    {
      "id": "b923179c-9617-4ac5-8601-8054755a2234",
      "parentCategoryId": "a123179c-9633-4ac5-8601-8054755a2a5c",
      "names": [
        {
          "locale": "en-US",
          "text": "2019 Healthe Living Rewards Program"
        }
      ],
      "descriptions": [
        {
          "locale": "en-US",
          "text": "2019 Healthe Living Rewards Program for Consumer Well-Being Campaign."
        }
      ],
      "reward": {
        "id": "11e8902c9e2908c69718f13503066bee",
        "value": "1",
        "limit": "10",
        "units": [
          {
            "singularName": "dollar",
            "pluralName": "dollars",
            "locale": "en-US"
          }
        ]
      },
      "adjustmentReward": {
        "id": "11e8902c9e2908c69718f13503066bee",
        "value": "1",
        "limit": "10",
        "units": [
          {
            "singularName": "dollar",
            "pluralName": "dollars",
            "locale": "en-US"
          }
        ]
      },
      "completionThreshold": 1,
      "icon": "category_2019_q1.jpg",
      "startsAt": "2019-01-01T00:00:00Z",
      "endsAt": "2019-12-31T23:59:00Z",
      "createdAt": "2018-12-15T12:23:12Z",
      "updatedAt": "2018-12-15T12:23:12Z",
      "objectives": [
        {
          "id": "c44718e2-623f-4202-a4bb-db3e5816d258",
          "activity_definition_id": "a66718e2-532d-2232-b6rt-dfe24343234",
          "position": 1,
          "titles": [
            {
              "locale": "en-US",
              "text": "Complete the PHA"
            }
          ],
          "descriptions": [
            {
              "locale": "en-US",
              "text": "Complete the personal health assessment (PHA) to earn 100 points."
            }
          ],
          "startsAt": "2019-01-01T00:00:00Z",
          "endsAt": "2019-12-31T23:59:00Z",
          "sourceDefinition": {
            "id": "c923179c-9617-4ac5-8601-8054755a2a5c",
            "kind": "wellness#healthyHabit"
          },
          "frequency": "QUARTERLY",
          "maxCompletionCount": 10,
          "primaryObjectiveId": "x123456q-9617-4ac5-8601-80547512345",
          "alternatives": [
            {}
          ],
          "conditions": [
            {
              "value": 100,
              "operator": ">",
              "target": 100,
              "consumerConditionType": "AGE",
              "subtype": "SYSTOLIC"
            }
          ],
          "codings": [
            {
              "referenceId": "26bed4ce-65f7-4cb8-9562-a055cdcf4f15|EXERCISE_OBSTYPE",
              "kind": "ontology#concept"
            }
          ],
          "sources": [
            "SELF_ENTERED"
          ],
          "incentive": {
            "id": "20556922-21e0-46dc-9224-7b914bb67b5d",
            "objectiveId": "12356922-21e0-46dc-9224-7b914bb67b5d",
            "rewardLimitPerFrequency": 5,
            "reward": {
              "id": "11e8902c9e2908c69718f13503066bee",
              "value": "1",
              "limit": "10",
              "units": [
                {
                  "singularName": "dollar",
                  "pluralName": "dollars",
                  "locale": "en-US"
                }
              ]
            }
          }
        }
      ],
      "categories": [
        {}
      ]
    }
  ],
  "objectives": [
    {
      "id": "c44718e2-623f-4202-a4bb-db3e5816d258",
      "activity_definition_id": "a66718e2-532d-2232-b6rt-dfe24343234",
      "position": 1,
      "titles": [
        {
          "locale": "en-US",
          "text": "Complete the PHA"
        }
      ],
      "descriptions": [
        {
          "locale": "en-US",
          "text": "Complete the personal health assessment (PHA) to earn 100 points."
        }
      ],
      "startsAt": "2019-01-01T00:00:00Z",
      "endsAt": "2019-12-31T23:59:00Z",
      "sourceDefinition": {
        "id": "c923179c-9617-4ac5-8601-8054755a2a5c",
        "kind": "wellness#healthyHabit"
      },
      "frequency": "QUARTERLY",
      "maxCompletionCount": 10,
      "primaryObjectiveId": "x123456q-9617-4ac5-8601-80547512345",
      "alternatives": [
        {}
      ],
      "conditions": [
        {
          "value": 100,
          "operator": ">",
          "target": 100,
          "consumerConditionType": "AGE",
          "subtype": "SYSTOLIC"
        }
      ],
      "codings": [
        {
          "referenceId": "26bed4ce-65f7-4cb8-9562-a055cdcf4f15|EXERCISE_OBSTYPE",
          "kind": "ontology#concept"
        }
      ],
      "sources": [
        "SELF_ENTERED"
      ],
      "incentive": {
        "id": "20556922-21e0-46dc-9224-7b914bb67b5d",
        "objectiveId": "12356922-21e0-46dc-9224-7b914bb67b5d",
        "rewardLimitPerFrequency": 5,
        "reward": {
          "id": "11e8902c9e2908c69718f13503066bee",
          "value": "1",
          "limit": "10",
          "units": [
            {
              "singularName": "dollar",
              "pluralName": "dollars",
              "locale": "en-US"
            }
          ]
        }
      }
    }
  ]
}

GET /campaign-instances/{campaignInstanceId}

Retrieves a single campaign instance by ID.

Parameters

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

Response Statuses

Status Meaning Description Schema
200 OK OK CampaignInstance
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Campaign Memberships

Campaign membership indicates a consumer is a participant in a wellness campaign.

Add a Campaign Member

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/wellness/v1/campaign-memberships', headers: headers, body: {"campaignId":"77a233a3-54d4-4ad3-9e63-53bb71762290","consumerId":"88a233a3-54d4-4ad3-9e63-53bb71762290"}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-memberships \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"campaignId":"77a233a3-54d4-4ad3-9e63-53bb71762290","consumerId":"88a233a3-54d4-4ad3-9e63-53bb71762290"}

Example response

{
  "id": "11e8902c9e2908c69718f13503066bee",
  "campaignId": "22e8902c9e2908c69718f13503066bee",
  "consumerId": "33e8902c9e2908c69718f13503066bee",
  "createdAt": "2018-12-15T12:23:12Z",
  "updatedAt": "2018-05-15T12:23:12Z"
}

POST /campaign-memberships

Adds a consumer to a specific campaign by creating a campaign membership for the campaign.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created CampaignMembership
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden

Retrieve a List of Campaign Memberships

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/wellness/v1/campaign-memberships', headers: headers)

print JSON.pretty_generate(result)


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

Example response

{
  "items": [
    {
      "id": "11e8902c9e2908c69718f13503066bee",
      "campaignId": "22e8902c9e2908c69718f13503066bee",
      "consumerId": "33e8902c9e2908c69718f13503066bee",
      "createdAt": "2018-12-15T12:23:12Z",
      "updatedAt": "2018-05-15T12:23:12Z"
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-memberships?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-memberships?offset=0&limit=20"
}

GET /campaign-memberships

Retrieves a list of campaign memberships.

Parameters

Parameter In Type Required Default Description Accepted Values
campaignId query array[string] false N/A The ID of the incentive campaign. -
consumerId query array[string] false N/A The ID of the consumer. -
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. updatedAt, -updatedAt, campaignId, consumerId

Response Statuses

Status Meaning Description Schema
200 OK OK CampaignMemberships
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden

Remove a Campaign Member

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/wellness/v1/campaign-memberships/11e8902c9e2908c69718f13503066bee', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-memberships/11e8902c9e2908c69718f13503066bee \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /campaign-memberships/{membershipId}

Removes a consumer from a campaign by deleting the specified campaign membership.

Parameters

Parameter In Type Required Default Description Accepted Values
membershipId path string true N/A The ID of the campaign membership. -

Response Statuses

Status Meaning Description Schema
204 No Content No Content None
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Retrieve a Single Campaign Membership

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/wellness/v1/campaign-memberships/11e8902c9e2908c69718f13503066bee', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-memberships/11e8902c9e2908c69718f13503066bee \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "11e8902c9e2908c69718f13503066bee",
  "campaignId": "22e8902c9e2908c69718f13503066bee",
  "consumerId": "33e8902c9e2908c69718f13503066bee",
  "createdAt": "2018-12-15T12:23:12Z",
  "updatedAt": "2018-05-15T12:23:12Z"
}

GET /campaign-memberships/{membershipId}

Retrieves a single campaign membership by ID.

Parameters

Parameter In Type Required Default Description Accepted Values
membershipId path string true N/A The ID of the campaign membership. -

Response Statuses

Status Meaning Description Schema
200 OK OK CampaignMembership
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Wellness Incentive Rewards

Wellness incentive rewards are tangible offers for completing incentivized activities. Rewards can be used to further entice the campaign member to achieve their and the campaign’s goals.

Create a Reward 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/wellness/v1/reward-definitions', headers: headers, body: {"value":1,"limit":10,"units":[{"singularName":"dollar","pluralName":"dollars","locale":"en-US"}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/reward-definitions \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"value":1,"limit":10,"units":[{"singularName":"dollar","pluralName":"dollars","locale":"en-US"}]}

Example response

{
  "id": "11e8902c9e2908c69718f13503066bee",
  "value": "1",
  "limit": "10",
  "units": [
    {
      "singularName": "dollar",
      "pluralName": "dollars",
      "locale": "en-US"
    }
  ]
}

POST /reward-definitions

Adds a wellness incentive reward definition.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created RewardDefinition
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden

Retrieves a List of Reward 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/wellness/v1/reward-definitions', headers: headers)

print JSON.pretty_generate(result)


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

Example response

{
  "items": [
    {
      "id": "11e8902c9e2908c69718f13503066bee",
      "value": "1",
      "limit": "10",
      "units": [
        {
          "singularName": "dollar",
          "pluralName": "dollars",
          "locale": "en-US"
        }
      ]
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness-rewards/v1/rewards?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness-rewards/v1/rewards?offset=0&limit=20"
}

GET /reward-definitions

Retrieves a list of wellness incentive reward definitions.

Parameters

Parameter In Type Required Default Description Accepted Values
id query array[string] false N/A Filters by the ID or IDs of one or many reward definitions. -
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. createdAt, updatedAt

Response Statuses

Status Meaning Description Schema
200 OK OK RewardDefinitions
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden

Delete a Reward 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/wellness/v1/reward-definitions/ffe6a5d1-d8f7-44c7-a7a4-37ec99bcc925', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/reward-definitions/ffe6a5d1-d8f7-44c7-a7a4-37ec99bcc925 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /reward-definitions/{rewardDefinitionId}

Deletes a wellness incentive reward definition by ID.

Parameters

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

Response Statuses

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

Update a Reward 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.patch('https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/reward-definitions/ffe6a5d1-d8f7-44c7-a7a4-37ec99bcc925', headers: headers, body: {"value":1,"limit":10,"units":[{"singularName":"dollar","pluralName":"dollars","locale":"en-US"}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PATCH https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/reward-definitions/ffe6a5d1-d8f7-44c7-a7a4-37ec99bcc925 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"value":1,"limit":10,"units":[{"singularName":"dollar","pluralName":"dollars","locale":"en-US"}]}

PATCH /reward-definitions/{rewardDefinitionId}

Updates a wellness incentive reward definition by ID.

Parameters

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

Response Statuses

Status Meaning Description Schema
204 No Content No Content. None
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Retrieve a Single Reward 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/wellness/v1/reward-definitions/ffadf1b7-b812-4eed-a769-f6a6c4c04b97', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/reward-definitions/ffadf1b7-b812-4eed-a769-f6a6c4c04b97 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "11e8902c9e2908c69718f13503066bee",
  "value": "1",
  "limit": "10",
  "units": [
    {
      "singularName": "dollar",
      "pluralName": "dollars",
      "locale": "en-US"
    }
  ]
}

GET /reward-definitions/{rewardDefinitionId}

Retrieves a single wellness incentive reward definition by ID.

Parameters

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

Response Statuses

Status Meaning Description Schema
200 OK OK RewardDefinition
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Retrieves a List of Rewards

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/wellness/v1/rewards', headers: headers)

print JSON.pretty_generate(result)


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

Example response

{
  "items": [
    {
      "id": "11ab9385-8c94-41c6-96b1-ab881ab93d88",
      "consumer": {
        "id": "6fe5d564-348d-41d9-888b-1f9bd45e985c"
      },
      "reward": {
        "id": "e394eda2-9053-4ab5-ac01-1e5284c746a1"
      },
      "earned": "2",
      "effective": "1",
      "createdAt": "2018-12-15T12:23:12Z",
      "updatedAt": "2018-12-15T12:23:12Z"
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness-rewards/v1/consumer-rewards?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness-rewards/v1/consumer-rewards?offset=0&limit=20"
}

GET /rewards

Retrieves a list of wellness incentive rewards.

Parameters

Parameter In Type Required Default Description Accepted Values
rewardId query array[string] false N/A Filters by the ID of the reward definition. -
consumerId query array[string] false N/A Filters by the ID of the consumer. -
campaignId query string false N/A Filters by the ID of the wellness campaign. -
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 OK ConsumerIncentiveRewardLists
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden

Retrieve a Single Reward

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/wellness/v1/rewards/ffe6a5d1-d8f7-44c7-a7a4-37ec99bcc925', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/rewards/ffe6a5d1-d8f7-44c7-a7a4-37ec99bcc925 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "11ab9385-8c94-41c6-96b1-ab881ab93d88",
  "consumer": {
    "id": "6fe5d564-348d-41d9-888b-1f9bd45e985c"
  },
  "reward": {
    "id": "e394eda2-9053-4ab5-ac01-1e5284c746a1"
  },
  "earned": "2",
  "effective": "1",
  "createdAt": "2018-12-15T12:23:12Z",
  "updatedAt": "2018-12-15T12:23:12Z",
  "transactions": [
    {
      "id": "5c82129d-e200-4905-b405-6004e45b3410",
      "delta": "1",
      "referenceSystem": {
        "id": "abc3179c-9617-4ac5-8601-8054755a2xyz",
        "kind": "STEPS"
      },
      "createdAt": "2018-12-15T12:23:12Z",
      "updatedAt": "2018-12-15T12:23:12Z"
    }
  ]
}

GET /rewards/{rewardId}

Retrieves a single wellness incentive reward by ID.

Parameters

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

Response Statuses

Status Meaning Description Schema
200 OK OK ConsumerIncentiveReward
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden
404 Not Found Not Found NotFound

Campaign Objectives

A campaign objective is an incentivized activity associated with a wellness campaign. Consumers receive incentive rewards by completing the objectives of a wellness campaign.

Retrieve a List of Campaign Objectives

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/wellness/v1/campaign-objectives', headers: headers)

print JSON.pretty_generate(result)


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

Example response

{
  "items": [
    {
      "consumer": {
        "id": "6fe5d564-348d-41d9-888b-1f9bd45e985c"
      },
      "objectiveDefinition": {
        "id": "c3368a32-78ca-4bfd-9d2a-47170d179f33",
        "sourceDefinition": {
          "id": "e1ab427f-5b22-468e-87a0-8968a6137933",
          "kind": "QUESTIONNAIRE"
        }
      },
      "overallStatus": "IN_PROGRESS",
      "overallCompletionCount": 10,
      "detailsByFrequency": [
        {
          "status": "IN_PROGRESS",
          "frequencyBeginsAt": "2019-08-01",
          "completionCount": 5,
          "activityCount": 3,
          "adminAwardedCount": 2,
          "consumerActivitySourceDefinitions": [
            {
              "id": "e54ac10a-31a3-499e-bb52-3821baef7009"
            }
          ]
        }
      ]
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-objectives?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-objectives?offset=0&limit=20"
}

GET /campaign-objectives

Retrieves a list of campaign objectives and their summarizing data.

Parameters

Parameter In Type Required Default Description Accepted Values
consumerId query array[string] false N/A Filters by the ID of the consumer. -
objectiveId query array[string] false N/A Filters by the ID of the objective. -
sourceDefinitionKind query string false N/A Filters by the source system in which the objective is defined. -
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 OK ObjectiveStatuses
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden

Complete a Campaign Objective

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/wellness/v1/campaign-objectives', headers: headers, body: {"consumer":{"id":"12342f22-93ca-4aa7-81ff-5811a9be1899"},"locale":"en-US","activity":{"sourceDefinition":{"id":"b7e15f69-841c-4244-8ace-350d071452ab","kind":"wellness#learningModules"},"id":"ea4a8ba6-eaed-46d2-832c-a7b52445f006","performedOn":"2019-01-01T00:00:00Z","name":"Dentist Visit","details":"Semi-Annual Checkup","providerName":"Dr. Smith, University City Hospital","providerLocation":"Kansas City, KC - 34444","status":"PENDING"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/campaign-objectives \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"consumer":{"id":"12342f22-93ca-4aa7-81ff-5811a9be1899"},"locale":"en-US","activity":{"sourceDefinition":{"id":"b7e15f69-841c-4244-8ace-350d071452ab","kind":"wellness#learningModules"},"id":"ea4a8ba6-eaed-46d2-832c-a7b52445f006","performedOn":"2019-01-01T00:00:00Z","name":"Dentist Visit","details":"Semi-Annual Checkup","providerName":"Dr. Smith, University City Hospital","providerLocation":"Kansas City, KC - 34444","status":"PENDING"}}

Example response

{
  "items": [
    {
      "campaign": {
        "id": "b923179c-9617-4ac5-8601-8054755a2a5c"
      },
      "completionCount": 5,
      "pointsAchieved": 200,
      "unit": {
        "unitSingularName": "dollar",
        "unitPluralName": "dollars"
      }
    }
  ]
}

POST /campaign-objectives

Completes a campaign objective.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created IncentiveCalculationList
400 Bad Request Bad Request BadRequest
401 Unauthorized Unauthorized Unauthorized
403 Forbidden Forbidden Forbidden

Objective Completion Requests

An objective completion request is a request to complete an objective associated with a wellness campaign. The objective completion request is reviewed by an administrator before it is completed.

Retrieve a List of Objective Completion Requests

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/wellness/v1/objective-completion-requests', headers: headers)

print JSON.pretty_generate(result)


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

Example response

{
  "items": [
    {
      "id": "1a7444c9-a5de-47c6-9c31-40ac041224f8",
      "consumer": {
        "id": "af0625e2-3b69-465e-bccf-72c163f5ecb5"
      },
      "objective": {
        "id": "31d78870-d203-4831-8244-6390715626f5"
      },
      "activity": {
        "performedAt": "2019-10-21",
        "name": "Annual Eye Exam",
        "fields": [
          {
            "id": "0becf9dd-3cce-493e-8773-3f829886e030",
            "value": "KC Eye Doctors, LLC"
          }
        ]
      },
      "status": "PENDING",
      "updatedAt": "2019-11-05T18:45:00.000Z",
      "proofOfObjectiveCompletions": {
        "id": "6ea3f9c5-0376-47bc-a03f-7ebac6316c29",
        "name": "receipt.pdf",
        "description": "The receipt of my dental exam.",
        "uploadedAt": "2019-11-04T18:42:00.000Z"
      }
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/objective-completion-requests?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/objective-completion-requests?offset=0&limit=20"
}

GET /objective-completion-requests

Retrieves a list of all the objective completion requests that satisfy the specified filters.

Parameters

Parameter In Type Required Default Description Accepted Values
status query string false N/A Filters by the status of an objective completion request. -
consumerId query string false N/A Filters by the ID of a HealtheIntent consumer. -
objectiveId query string false N/A Filters by the ID of an objective. -
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 Success ObjectiveCompletionRequests
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Create an Objective Completion Request

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/wellness/v1/objective-completion-requests', headers: headers, body: {"consumer":{"id":"af0625e2-3b69-465e-bccf-72c163f5ecb5"},"objective":{"id":"31d78870-d203-4831-8244-6390715626f5"},"activity":{"performedAt":"2019-10-21","name":"Annual Eye Exam","fields":[{"id":"0becf9dd-3cce-493e-8773-3f829886e030","value":"KC Eye Doctors, LLC"}]},"status":"PENDING","proofOfObjectiveCompletions":[{"id":"6ea3f9c5-0376-47bc-a03f-7ebac6316c29"}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/objective-completion-requests \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"consumer":{"id":"af0625e2-3b69-465e-bccf-72c163f5ecb5"},"objective":{"id":"31d78870-d203-4831-8244-6390715626f5"},"activity":{"performedAt":"2019-10-21","name":"Annual Eye Exam","fields":[{"id":"0becf9dd-3cce-493e-8773-3f829886e030","value":"KC Eye Doctors, LLC"}]},"status":"PENDING","proofOfObjectiveCompletions":[{"id":"6ea3f9c5-0376-47bc-a03f-7ebac6316c29"}]}

Example response

{
  "id": "1a7444c9-a5de-47c6-9c31-40ac041224f8",
  "consumer": {
    "id": "af0625e2-3b69-465e-bccf-72c163f5ecb5"
  },
  "objective": {
    "id": "31d78870-d203-4831-8244-6390715626f5"
  },
  "activity": {
    "performedAt": "2019-10-21",
    "name": "Annual Eye Exam",
    "fields": [
      {
        "id": "0becf9dd-3cce-493e-8773-3f829886e030",
        "value": "KC Eye Doctors, LLC"
      }
    ]
  },
  "status": "PENDING",
  "updatedAt": "2019-11-05T18:45:00.000Z",
  "proofOfObjectiveCompletions": {
    "id": "6ea3f9c5-0376-47bc-a03f-7ebac6316c29",
    "name": "receipt.pdf",
    "description": "The receipt of my dental exam.",
    "uploadedAt": "2019-11-04T18:42:00.000Z"
  }
}

POST /objective-completion-requests

Creates a new request to complete an objective. If the status is set to PENDING, the objective completion request needs to be reviewed by an administrator before the objective is completed for the consumer. If the status is set to APPROVED, the objective is completed for the consumer without an administrator’s review.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created ObjectiveCompletionRequest
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Update an Objective Completion Request

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/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8', headers: headers, body: {"consumer":{"id":"af0625e2-3b69-465e-bccf-72c163f5ecb5"},"objective":{"id":"31d78870-d203-4831-8244-6390715626f5"},"activity":{"performedAt":"2019-10-21","name":"Annual Eye Exam","fields":[{"id":"0becf9dd-3cce-493e-8773-3f829886e030","value":"KC Eye Doctors, LLC"}]},"status":"PENDING","proofOfObjectiveCompletions":[{"id":"6ea3f9c5-0376-47bc-a03f-7ebac6316c29"}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"consumer":{"id":"af0625e2-3b69-465e-bccf-72c163f5ecb5"},"objective":{"id":"31d78870-d203-4831-8244-6390715626f5"},"activity":{"performedAt":"2019-10-21","name":"Annual Eye Exam","fields":[{"id":"0becf9dd-3cce-493e-8773-3f829886e030","value":"KC Eye Doctors, LLC"}]},"status":"PENDING","proofOfObjectiveCompletions":[{"id":"6ea3f9c5-0376-47bc-a03f-7ebac6316c29"}]}

PUT /objective-completion-requests/{objectiveCompletionRequestId}

Updates an objective completion request by the given ID.

Note: A request cannot be updated if its status is set to APPROVED.

Parameters

Parameter In Type Required Default Description Accepted Values
objectiveCompletionRequestId path string true N/A The ID of the objective completion request. -
body body putObjectiveCompletionRequests true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content Updated None
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Delete an Objective Completion Request

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/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /objective-completion-requests/{objectiveCompletionRequestId}

Deletes an objective completion request by the given ID.

Note: A request cannot be deleted if its status is set to APPROVED.

Parameters

Parameter In Type Required Default Description Accepted Values
objectiveCompletionRequestId path string true N/A The ID of the objective completion request. -

Response Statuses

Status Meaning Description Schema
204 No Content Deleted None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single Objective Completion Request

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/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "1a7444c9-a5de-47c6-9c31-40ac041224f8",
  "consumer": {
    "id": "af0625e2-3b69-465e-bccf-72c163f5ecb5"
  },
  "objective": {
    "id": "31d78870-d203-4831-8244-6390715626f5"
  },
  "activity": {
    "performedAt": "2019-10-21",
    "name": "Annual Eye Exam",
    "fields": [
      {
        "id": "0becf9dd-3cce-493e-8773-3f829886e030",
        "value": "KC Eye Doctors, LLC"
      }
    ]
  },
  "status": "PENDING",
  "updatedAt": "2019-11-05T18:45:00.000Z",
  "proofOfObjectiveCompletions": {
    "id": "6ea3f9c5-0376-47bc-a03f-7ebac6316c29",
    "name": "receipt.pdf",
    "description": "The receipt of my dental exam.",
    "uploadedAt": "2019-11-04T18:42:00.000Z"
  }
}

GET /objective-completion-requests/{objectiveCompletionRequestId}

Retrieves a single objective completion request by the given ID.

Parameters

Parameter In Type Required Default Description Accepted Values
objectiveCompletionRequestId path string true N/A The ID of the objective completion request. -

Response Statuses

Status Meaning Description Schema
200 OK Success ObjectiveCompletionRequest
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Create a Review for a Request to Complete an Objective

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/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8/reviews', headers: headers, body: {"status":"DENIED","reason":"The proof of objective completion date does not match the performed at date."}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8/reviews \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"status":"DENIED","reason":"The proof of objective completion date does not match the performed at date."}

Example response

{
  "id": "dfb9cd66-b486-4e94-aa4a-6f453671e70f",
  "status": "DENIED",
  "reason": "The proof of objective completion date does not match the performed at date.",
  "createdAt": "2019-11-05T18:45:00.000Z"
}

POST /objective-completion-requests/{objectiveCompletionRequestId}/reviews

Creates a new review. The review is used to record that the objective completion request was approved or denied. This updates the status of the associated objective completion request to the status of the review.

Parameters

Parameter In Type Required Default Description Accepted Values
objectiveCompletionRequestId path string true N/A The ID of the objective completion request. -
body body postObjectiveCompletionRequestsObjectivecompletionrequestidReviews true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created Created ObjectiveCompletionReview
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Retrieve a List of Reviews

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/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8/reviews', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8/reviews \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "dfb9cd66-b486-4e94-aa4a-6f453671e70f",
      "status": "DENIED",
      "reason": "The proof of objective completion date does not match the performed at date.",
      "createdAt": "2019-11-05T18:45:00.000Z"
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8/reviews?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8/reviews?offset=0&limit=20"
}

GET /objective-completion-requests/{objectiveCompletionRequestId}/reviews

Retrieves a list of all the reviews that satisfy the specified filters.

Parameters

Parameter In Type Required Default Description Accepted Values
objectiveCompletionRequestId path string true N/A The ID of the objective completion request. -
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 Success ObjectiveCompletionReviews
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Delete a Review for a Request to Complete an Objective

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/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8/reviews/6ea3f9c5-0376-47bc-a03f-7ebac6316c29', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8/reviews/6ea3f9c5-0376-47bc-a03f-7ebac6316c29 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /objective-completion-requests/{objectiveCompletionRequestId}/reviews/{reviewId}

Deletes a review by the given ID.

Parameters

Parameter In Type Required Default Description Accepted Values
objectiveCompletionRequestId path string true N/A The ID of the objective completion request. -
reviewId path string true N/A The ID of the objective completion review. -

Response Statuses

Status Meaning Description Schema
204 No Content Deleted None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Update a Review for a Request to Complete an Objective

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/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8/reviews/6ea3f9c5-0376-47bc-a03f-7ebac6316c29', headers: headers, body: {"status":"DENIED","reason":"The proof of objective completion date does not match the performed at date."}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8/reviews/6ea3f9c5-0376-47bc-a03f-7ebac6316c29 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"status":"DENIED","reason":"The proof of objective completion date does not match the performed at date."}

PUT /objective-completion-requests/{objectiveCompletionRequestId}/reviews/{reviewId}

Updates a review by the given ID.

Parameters

Parameter In Type Required Default Description Accepted Values
objectiveCompletionRequestId path string true N/A The ID of the objective completion request. -
reviewId path string true N/A The ID of the objective completion review. -
body body putObjectiveCompletionRequestsObjectivecompletionrequestidReviews true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content Updated None
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single Review for a Request to Complete an Objective

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/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8/reviews/6ea3f9c5-0376-47bc-a03f-7ebac6316c29', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/objective-completion-requests/1a7444c9-a5de-47c6-9c31-40ac041224f8/reviews/6ea3f9c5-0376-47bc-a03f-7ebac6316c29 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "dfb9cd66-b486-4e94-aa4a-6f453671e70f",
  "status": "DENIED",
  "reason": "The proof of objective completion date does not match the performed at date.",
  "createdAt": "2019-11-05T18:45:00.000Z"
}

GET /objective-completion-requests/{objectiveCompletionRequestId}/reviews/{reviewId}

Retrieves a single review by the given IDs.

Parameters

Parameter In Type Required Default Description Accepted Values
objectiveCompletionRequestId path string true N/A The ID of the objective completion request. -
reviewId path string true N/A The ID of the objective completion review. -

Response Statuses

Status Meaning Description Schema
200 OK Success ObjectiveCompletionReview
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a List of Proof of Objective Completions

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/wellness/v1/proof-of-objective-completions', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/proof-of-objective-completions \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "6ea3f9c5-0376-47bc-a03f-7ebac6316c29",
      "name": "receipt.pdf",
      "description": "The receipt of my dental exam.",
      "consumer": {
        "id": "af0625e2-3b69-465e-bccf-72c163f5ecb5"
      },
      "uploadedAt": "2019-11-04T18:42:00.000Z"
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/proof-of-objective-completions?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/proof-of-objective-completions?offset=0&limit=20"
}

GET /proof-of-objective-completions

Retrieves a list of all the proof of objective completions that satisfy the specified filters.

Parameters

Parameter In Type Required Default Description Accepted Values
consumerId query string false N/A Filters by the ID of a HealtheIntent consumer. -
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 Success ProofOfObjectiveCompletions
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Create a Proof of Objective Completion

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/wellness/v1/proof-of-objective-completions', headers: headers)

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/proof-of-objective-completions \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json'

Example response

{
  "id": "6ea3f9c5-0376-47bc-a03f-7ebac6316c29",
  "name": "receipt.pdf",
  "description": "The receipt of my dental exam.",
  "consumer": {
    "id": "af0625e2-3b69-465e-bccf-72c163f5ecb5"
  },
  "uploadedAt": "2019-11-04T18:42:00.000Z"
}

POST /proof-of-objective-completions

Creates a new proof of objective completion. The proof of objective completion is used to upload a file that provides evidence for the objective completion request. This resource uses a multipart/form-data request to upload the metadata of the proof of completion plus one file, for example, a .PDF, .PNG, or .JPEG image. The maximum size for the proof of objective completion file is one MB. The allowed content types for the file are application/pdf, image/png, and image/jpeg. See the RFC 7578 page on the Internet Engineering Task Force (IETF) website for more information about the multipart/form-data request.

Body Example:

Content-Type: multipart/form-data; boundary=287032381131322

–287032381131322
Content-Disposition: form-data; name=“name”

receipt.pdf
–287032381131322
Content-Disposition: form-data; name=“description”

The receipt of my dental exam.
–287032381131322
Content-Disposition: form-data; name=“consumer[id]”

af0625e2-3b69-465e-bccf-72c163f5ecb5
–287032381131322
Content-Disposition: form-data; name=“file”; filename=“receipt.pdf”
Content-Type: application/pdf

[binary data]

–287032381131322–

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created ProofOfObjectiveCompletion
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Delete a Proof of Objective Completion

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/wellness/v1/proof-of-objective-completions/6ea3f9c5-0376-47bc-a03f-7ebac6316c29', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/proof-of-objective-completions/6ea3f9c5-0376-47bc-a03f-7ebac6316c29 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /proof-of-objective-completions/{proofOfObjectiveCompletionId}

Deletes a proof of objective completion by the given ID.

Note: A proof of objective completion that is reviewed cannot be deleted.

Parameters

Parameter In Type Required Default Description Accepted Values
proofOfObjectiveCompletionId path string true N/A The ID of the proof of objective completion. -

Response Statuses

Status Meaning Description Schema
204 No Content Deleted None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single Proof of Objective Completion

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/wellness/v1/proof-of-objective-completions/6ea3f9c5-0376-47bc-a03f-7ebac6316c29', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/proof-of-objective-completions/6ea3f9c5-0376-47bc-a03f-7ebac6316c29 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "6ea3f9c5-0376-47bc-a03f-7ebac6316c29",
  "name": "receipt.pdf",
  "description": "The receipt of my dental exam.",
  "consumer": {
    "id": "af0625e2-3b69-465e-bccf-72c163f5ecb5"
  },
  "uploadedAt": "2019-11-04T18:42:00.000Z"
}

GET /proof-of-objective-completions/{proofOfObjectiveCompletionId}

Retrieves a single proof of objective completion by the given ID.

Response Example:

Content-Type: application/pdf;
Content-Disposition: attachment; filename=receipt.pdf

[binary data]

Parameters

Parameter In Type Required Default Description Accepted Values
proofOfObjectiveCompletionId path string true N/A The ID of the proof of objective completion. -

Response Statuses

Status Meaning Description Schema
200 OK Success ProofOfObjectiveCompletion
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Personal Health Assessment

A personal health assessment (PHA) is a structured set of questions and instructions presented to collect answers from HealtheIntent consumers. The PHA endpoints enable the creation and presentation of PHAs and their answers.

Retrieve a List of PHA 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/wellness/v1/pha-definitions', headers: headers)

print JSON.pretty_generate(result)


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

Example response

{
  "items": [
    {
      "id": "e61dd2fa-702d-11e9-a923-1681be663d3e",
      "phaId": "ace20324-a0b9-11e8-98d0-529269fb1459",
      "name": "Cerner Demo Personal Health Assessment 2019",
      "locale": "en-US",
      "description": "Cerner Demo Personal Health Assessment 2019 is a wellness assessment to evaluate the overall physical and mental health of a person.",
      "code": {
        "system": "urn:ietf:rfc:3986",
        "code": "2-16-840-1-113883-6-1",
        "display": "Personal Health Assessment"
      }
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions?offset=0&limit=20"
}

GET /pha-definitions

Retrieves a list of all the available PHA definitions.

Parameters

Parameter In Type Required Default Description Accepted Values
phaId query string false N/A Filters by the ID of a PHA. -
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 Success PhaDefinitions
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Create a PHA 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/wellness/v1/pha-definitions', headers: headers, body: {"name":"Cerner Demo Personal Health Assessment 2019","phaId":"ace20324-a0b9-11e8-98d0-529269fb1459","locale":"en-US","description":"Cerner Demo Personal Health Assessment 2019 is a wellness assessment to evaluate the overall physical and mental health of a person.","code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Cerner Demo Personal Health Assessment 2019","phaId":"ace20324-a0b9-11e8-98d0-529269fb1459","locale":"en-US","description":"Cerner Demo Personal Health Assessment 2019 is a wellness assessment to evaluate the overall physical and mental health of a person.","code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}

Example response

{
  "id": "e61dd2fa-702d-11e9-a923-1681be663d3e",
  "phaId": "ace20324-a0b9-11e8-98d0-529269fb1459",
  "name": "Cerner Demo Personal Health Assessment 2019",
  "locale": "en-US",
  "description": "Cerner Demo Personal Health Assessment 2019 is a wellness assessment to evaluate the overall physical and mental health of a person.",
  "code": {
    "system": "urn:ietf:rfc:3986",
    "code": "2-16-840-1-113883-6-1",
    "display": "Personal Health Assessment"
  }
}

POST /pha-definitions

Creates a new PHA definition. A PHA definition is a structured set of questions and instructions that is presented to help collect answers from HealtheIntent consumers.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created PhaDefinition
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Delete a PHA 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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /pha-definitions/{phaDefinitionId}

Deletes a PHA definition.

Parameters

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

Response Statuses

Status Meaning Description Schema
204 No Content Deleted None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Update a PHA 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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e', headers: headers, body: {"name":"Cerner Demo Personal Health Assessment 2019","phaId":"ace20324-a0b9-11e8-98d0-529269fb1459","locale":"en-US","description":"Cerner Demo Personal Health Assessment 2019 is a wellness assessment to evaluate the overall physical and mental health of a person.","code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Cerner Demo Personal Health Assessment 2019","phaId":"ace20324-a0b9-11e8-98d0-529269fb1459","locale":"en-US","description":"Cerner Demo Personal Health Assessment 2019 is a wellness assessment to evaluate the overall physical and mental health of a person.","code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}

PUT /pha-definitions/{phaDefinitionId}

Updates a PHA definition.

Parameters

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

Response Statuses

Status Meaning Description Schema
204 No Content Updated None
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single PHA 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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "e61dd2fa-702d-11e9-a923-1681be663d3e",
  "phaId": "ace20324-a0b9-11e8-98d0-529269fb1459",
  "name": "Cerner Demo Personal Health Assessment 2019",
  "locale": "en-US",
  "description": "Cerner Demo Personal Health Assessment 2019 is a wellness assessment to evaluate the overall physical and mental health of a person.",
  "code": {
    "system": "urn:ietf:rfc:3986",
    "code": "2-16-840-1-113883-6-1",
    "display": "Personal Health Assessment"
  }
}

GET /pha-definitions/{phaDefinitionId}

Retrieves a single PHA definition.

Parameters

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

Response Statuses

Status Meaning Description Schema
200 OK Success PhaDefinition
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a List of PHA Sections

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/sections', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/sections \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
      "name": "Nutrition",
      "description": "The nutritional assessment is an evaluation of dietary intake and nutrition status to identify the presence of malnutrition, obesity, and so on.",
      "position": 1,
      "code": {
        "system": "urn:ietf:rfc:3986",
        "code": "2-16-840-1-113883-6-1",
        "display": "Personal Health Assessment"
      }
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/sections?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/sections?offset=0&limit=20"
}

GET /pha-definitions/{phaDefinitionId}/sections

Retrieves a list of all the available sections of a PHA definition.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
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 Success PhaSections
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Create a PHA Section

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/sections', headers: headers, body: {"name":"Nutrition","description":"The nutritional assessment is an evaluation of dietary intake and nutrition status to identify the presence of malnutrition, obesity, and so on.","position":1,"code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/sections \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Nutrition","description":"The nutritional assessment is an evaluation of dietary intake and nutrition status to identify the presence of malnutrition, obesity, and so on.","position":1,"code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}

Example response

{
  "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
  "name": "Nutrition",
  "description": "The nutritional assessment is an evaluation of dietary intake and nutrition status to identify the presence of malnutrition, obesity, and so on.",
  "position": 1,
  "code": {
    "system": "urn:ietf:rfc:3986",
    "code": "2-16-840-1-113883-6-1",
    "display": "Personal Health Assessment"
  }
}

POST /pha-definitions/{phaDefinitionId}/sections

Creates a new PHA section for a PHA definition. A PHA section is a structured group that contains subsections and questions for a PHA.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created PhaSection
400 Bad Request Bad Request. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- PositionNotUnique A section already exists for the specified position.
BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Delete a PHA Section

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/sections/9a7be7c8-5c65-11e9-8647-d663bd873d93', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/sections/9a7be7c8-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /pha-definitions/{phaDefinitionId}/sections/{sectionId}

Deletes a PHA section for a PHA definition.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
sectionId path string true N/A The ID of the PHA section. -

Response Statuses

Status Meaning Description Schema
204 No Content Deleted None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Update a PHA Section

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/sections/9a7be7c8-5c65-11e9-8647-d663bd873d93', headers: headers, body: {"name":"Nutrition","description":"The nutritional assessment is an evaluation of dietary intake and nutrition status to identify the presence of malnutrition, obesity, and so on.","position":1,"code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/sections/9a7be7c8-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Nutrition","description":"The nutritional assessment is an evaluation of dietary intake and nutrition status to identify the presence of malnutrition, obesity, and so on.","position":1,"code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}

PUT /pha-definitions/{phaDefinitionId}/sections/{sectionId}

Updates a PHA section for a PHA definition.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
sectionId path string true N/A The ID of the PHA section. -
body body putPhaDefinitionsPhadefinitionidSections true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content Updated None
400 Bad Request Bad Request. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- PositionNotUnique A section already exists for the specified position.
BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single PHA Section

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/sections/9a7be7c8-5c65-11e9-8647-d663bd873d93', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/sections/9a7be7c8-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
  "name": "Nutrition",
  "description": "The nutritional assessment is an evaluation of dietary intake and nutrition status to identify the presence of malnutrition, obesity, and so on.",
  "position": 1,
  "code": {
    "system": "urn:ietf:rfc:3986",
    "code": "2-16-840-1-113883-6-1",
    "display": "Personal Health Assessment"
  }
}

GET /pha-definitions/{phaDefinitionId}/sections/{sectionId}

Retrieves a single PHA section of a PHA definition for a HealtheIntent tenant.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
sectionId path string true N/A The ID of the PHA section. -

Response Statuses

Status Meaning Description Schema
200 OK Success PhaSection
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a List of PHA Subsections

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/subsections', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/subsections \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "9a7be7c8-5c65-11e9-8647-d663bd873d93",
      "name": "Nutrition-Fats",
      "description": "Nutrition-Fats is the subset of nutrition questions that evaluates fats in the diet of *HealtheIntent* consumers.",
      "position": 1,
      "code": {
        "system": "urn:ietf:rfc:3986",
        "code": "2-16-840-1-113883-6-1",
        "display": "Personal Health Assessment"
      },
      "section": {
        "id": "12345678-120b-4c1e-81e4-3d3ae9c7580e"
      }
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/subsections?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/subsections?offset=0&limit=20"
}

GET /pha-definitions/{phaDefinitionId}/subsections

Retrieves a list of all the available subsections for a PHA definition.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
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 Success PhaSubsections
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Create a PHA Subsection

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/subsections', headers: headers, body: {"name":"Nutrition-Fats","description":"Nutrition-Fats is the subset of nutrition questions that evaluates fats in the diet of *HealtheIntent* consumers.","position":1,"code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"},"section":{"id":"12345678-120b-4c1e-81e4-3d3ae9c7580e"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/subsections \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Nutrition-Fats","description":"Nutrition-Fats is the subset of nutrition questions that evaluates fats in the diet of *HealtheIntent* consumers.","position":1,"code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"},"section":{"id":"12345678-120b-4c1e-81e4-3d3ae9c7580e"}}

Example response

{
  "id": "9a7be7c8-5c65-11e9-8647-d663bd873d93",
  "name": "Nutrition-Fats",
  "description": "Nutrition-Fats is the subset of nutrition questions that evaluates fats in the diet of *HealtheIntent* consumers.",
  "position": 1,
  "code": {
    "system": "urn:ietf:rfc:3986",
    "code": "2-16-840-1-113883-6-1",
    "display": "Personal Health Assessment"
  },
  "section": {
    "id": "12345678-120b-4c1e-81e4-3d3ae9c7580e"
  }
}

POST /pha-definitions/{phaDefinitionId}/subsections

Creates a new PHA subsection for a PHA definition. A PHA subsection is a structured subgroup in a PHA section that contains questions for a PHA.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created PhaSubsection
400 Bad Request Bad Request. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- SectionNotFound The PHA section specified for the subsection does not exist.
- PositionNotUnique A section already exists for the specified position.
BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Delete a PHA Subsection

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/subsections/ace20324-a0b9-11e8-98d0-529269fb1459', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/subsections/ace20324-a0b9-11e8-98d0-529269fb1459 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /pha-definitions/{phaDefinitionId}/subsections/{subsectionId}

Deletes a PHA subsection for a PHA definition.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
subsectionId path string true N/A The ID of the PHA subsection. -

Response Statuses

Status Meaning Description Schema
204 No Content Deleted None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Update a PHA Subsection

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/subsections/ace20324-a0b9-11e8-98d0-529269fb1459', headers: headers, body: {"name":"Nutrition-Fats","description":"Nutrition-Fats is the subset of nutrition questions that evaluates fats in the diet of *HealtheIntent* consumers.","position":1,"code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"},"section":{"id":"12345678-120b-4c1e-81e4-3d3ae9c7580e"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/subsections/ace20324-a0b9-11e8-98d0-529269fb1459 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Nutrition-Fats","description":"Nutrition-Fats is the subset of nutrition questions that evaluates fats in the diet of *HealtheIntent* consumers.","position":1,"code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"},"section":{"id":"12345678-120b-4c1e-81e4-3d3ae9c7580e"}}

PUT /pha-definitions/{phaDefinitionId}/subsections/{subsectionId}

Updates a PHA subsection for a PHA definition.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
subsectionId path string true N/A The ID of the PHA subsection. -
body body putPhaDefinitionsPhadefinitionidSubsections true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content Updated None
400 Bad Request Bad Request. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- SectionNotFound The PHA section specified for the subsection does not exist.
- PositionNotUnique A section already exists for the specified position.
BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single PHA Subsection

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/subsections/ace20324-a0b9-11e8-98d0-529269fb1459', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/subsections/ace20324-a0b9-11e8-98d0-529269fb1459 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "9a7be7c8-5c65-11e9-8647-d663bd873d93",
  "name": "Nutrition-Fats",
  "description": "Nutrition-Fats is the subset of nutrition questions that evaluates fats in the diet of *HealtheIntent* consumers.",
  "position": 1,
  "code": {
    "system": "urn:ietf:rfc:3986",
    "code": "2-16-840-1-113883-6-1",
    "display": "Personal Health Assessment"
  },
  "section": {
    "id": "12345678-120b-4c1e-81e4-3d3ae9c7580e"
  }
}

GET /pha-definitions/{phaDefinitionId}/subsections/{subsectionId}

Retrieves a single PHA subsection for a PHA definition.

Parameters

Parameter In Type Required Default Description Accepted Values
subsectionId path string true N/A The ID of the PHA subsection. -
phaDefinitionId path string true N/A The ID of the PHA definition. -

Response Statuses

Status Meaning Description Schema
200 OK Success PhaSubsection
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a List of PHA Questions

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/questions', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/questions \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
      "text": "How many times do you eat junk food in a week?",
      "type": "RANGE",
      "description": "Junk food is food that is highly processed; high in calories, sugars, salt, and trans fat; and low in nutrients.",
      "acceptsMultipleAnswers": true,
      "required": true,
      "position": 1,
      "section": {
        "id": "12345678-120b-4c1e-81e4-3d3ae9c7580e"
      },
      "subsection": {
        "id": "9a7be4e4-5c65-11e9-8647-d663bd873d93"
      },
      "code": {
        "system": "urn:ietf:rfc:3986",
        "code": "2-16-840-1-113883-6-1",
        "display": "Personal Health Assessment"
      },
      "options": [
        {
          "id": "bce10324-a0b9-11e8-98d0-529269fb1459",
          "choice": {
            "points": 5,
            "text": "Between 1 and 25"
          },
          "range": {
            "low": 1,
            "high": 7,
            "text": "Number of days in a week."
          }
        }
      ]
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/questions?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/questions?offset=0&limit=20"
}

GET /pha-definitions/{phaDefinitionId}/questions

Retrieves a list of all of the available questions.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
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 Success PhaQuestions
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Create a PHA Question

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/questions', headers: headers, body: {"text":"How many times do you eat junk food in a week?","type":"RANGE","description":"Junk food is food that is highly processed; high in calories, sugars, salt, and trans fat; and low in nutrients.","acceptsMultipleAnswers":true,"required":true,"position":1,"section":{"id":"12345678-120b-4c1e-81e4-3d3ae9c7580e"},"subsection":{"id":"9a7be4e4-5c65-11e9-8647-d663bd873d93"},"code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"},"options":[{"choice":{"points":5,"text":"Between 1 and 25"},"range":{"low":1,"high":7,"text":"Number of days in a week."}}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/questions \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"text":"How many times do you eat junk food in a week?","type":"RANGE","description":"Junk food is food that is highly processed; high in calories, sugars, salt, and trans fat; and low in nutrients.","acceptsMultipleAnswers":true,"required":true,"position":1,"section":{"id":"12345678-120b-4c1e-81e4-3d3ae9c7580e"},"subsection":{"id":"9a7be4e4-5c65-11e9-8647-d663bd873d93"},"code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"},"options":[{"choice":{"points":5,"text":"Between 1 and 25"},"range":{"low":1,"high":7,"text":"Number of days in a week."}}]}

Example response

{
  "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
  "text": "How many times do you eat junk food in a week?",
  "type": "RANGE",
  "description": "Junk food is food that is highly processed; high in calories, sugars, salt, and trans fat; and low in nutrients.",
  "acceptsMultipleAnswers": true,
  "required": true,
  "position": 1,
  "section": {
    "id": "12345678-120b-4c1e-81e4-3d3ae9c7580e"
  },
  "subsection": {
    "id": "9a7be4e4-5c65-11e9-8647-d663bd873d93"
  },
  "code": {
    "system": "urn:ietf:rfc:3986",
    "code": "2-16-840-1-113883-6-1",
    "display": "Personal Health Assessment"
  },
  "options": [
    {
      "id": "bce10324-a0b9-11e8-98d0-529269fb1459",
      "choice": {
        "points": 5,
        "text": "Between 1 and 25"
      },
      "range": {
        "low": 1,
        "high": 7,
        "text": "Number of days in a week."
      }
    }
  ]
}

POST /pha-definitions/{phaDefinitionId}/questions

Creates a new PHA question. A PHA question defines the information necessary to guide the collection of answers from a HealtheIntent consumer about their health and wellness habits.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created PhaQuestion
400 Bad Request Bad Request. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- SectionNotFound The PHA section specified for the question does not exist.
- SubsectionNotFound The PHA subsection specified for the question does not exist.
- PositionNotUnique A question already exists for the specified position.
- MissingOption An option was not specified for a range, choice, or open choice question.
- InvalidOptionType The type of option (choice or range) is not valid for the specified type of question.
BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Delete a PHA Question

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/questions/ace20324-a0b9-11e8-98d0-529269fb1459', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/questions/ace20324-a0b9-11e8-98d0-529269fb1459 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /pha-definitions/{phaDefinitionId}/questions/{questionId}

Deletes a PHA question.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
questionId path string true N/A The ID of the PHA question. -

Response Statuses

Status Meaning Description Schema
204 No Content Deleted None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Update a PHA Question

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/questions/ace20324-a0b9-11e8-98d0-529269fb1459', headers: headers, body: {"text":"How many times do you eat junk food in a week?","type":"RANGE","description":"Junk food is food that is highly processed; high in calories, sugars, salt, and trans fat; and low in nutrients.","acceptsMultipleAnswers":true,"required":true,"position":1,"section":{"id":"12345678-120b-4c1e-81e4-3d3ae9c7580e"},"subsection":{"id":"9a7be4e4-5c65-11e9-8647-d663bd873d93"},"code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"},"options":[{"choice":{"points":5,"text":"Between 1 and 25"},"range":{"low":1,"high":7,"text":"Number of days in a week."}}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/questions/ace20324-a0b9-11e8-98d0-529269fb1459 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"text":"How many times do you eat junk food in a week?","type":"RANGE","description":"Junk food is food that is highly processed; high in calories, sugars, salt, and trans fat; and low in nutrients.","acceptsMultipleAnswers":true,"required":true,"position":1,"section":{"id":"12345678-120b-4c1e-81e4-3d3ae9c7580e"},"subsection":{"id":"9a7be4e4-5c65-11e9-8647-d663bd873d93"},"code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"},"options":[{"choice":{"points":5,"text":"Between 1 and 25"},"range":{"low":1,"high":7,"text":"Number of days in a week."}}]}

PUT /pha-definitions/{phaDefinitionId}/questions/{questionId}

Updates a PHA question.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
questionId path string true N/A The ID of the PHA question. -
body body putPhaDefinitionsPhadefinitionidQuestions true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content Updated None
400 Bad Request Bad Request. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- SectionNotFound The PHA section specified for the question does not exist.
- SubsectionNotFound The PHA subsection specified for the question does not exist.
- PositionNotUnique A question already exists for the specified position.
- MissingOption An option was not specified for a range, choice, or open choice question.
- InvalidOptionType The type of option (choice or range) is not valid for the specified type of question.
BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single PHA Question

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/questions/ace20324-a0b9-11e8-98d0-529269fb1459', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/questions/ace20324-a0b9-11e8-98d0-529269fb1459 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
  "text": "How many times do you eat junk food in a week?",
  "type": "RANGE",
  "description": "Junk food is food that is highly processed; high in calories, sugars, salt, and trans fat; and low in nutrients.",
  "acceptsMultipleAnswers": true,
  "required": true,
  "position": 1,
  "section": {
    "id": "12345678-120b-4c1e-81e4-3d3ae9c7580e"
  },
  "subsection": {
    "id": "9a7be4e4-5c65-11e9-8647-d663bd873d93"
  },
  "code": {
    "system": "urn:ietf:rfc:3986",
    "code": "2-16-840-1-113883-6-1",
    "display": "Personal Health Assessment"
  },
  "options": [
    {
      "id": "bce10324-a0b9-11e8-98d0-529269fb1459",
      "choice": {
        "points": 5,
        "text": "Between 1 and 25"
      },
      "range": {
        "low": 1,
        "high": 7,
        "text": "Number of days in a week."
      }
    }
  ]
}

GET /pha-definitions/{phaDefinitionId}/questions/{questionId}

Retrieves a single PHA question.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
questionId path string true N/A The ID of the PHA question. -

Response Statuses

Status Meaning Description Schema
200 OK Success PhaQuestion
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a List of PHA Rules

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/rules', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/rules \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "11120324-a0b9-11e8-98d0-529269fb1459",
      "relation": "AND",
      "conditions": [
        {
          "question": {
            "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
          },
          "type": "ONE_OF",
          "values": [
            {
              "option": {
                "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
              },
              "operator": "GT",
              "value": 12
            }
          ]
        }
      ],
      "action": {
        "questions": [
          {
            "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
          }
        ]
      }
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/rules?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/rules?offset=0&limit=20"
}

GET /pha-definitions/{phaDefinitionId}/rules

Retrieves a list of all the available rules for a PHA definition.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
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 Success PhaRules
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Create a PHA Rule

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/rules', headers: headers, body: {"relation":"AND","conditions":[{"question":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"type":"ONE_OF","values":[{"option":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"operator":"GT","value":12}]}],"action":{"questions":[{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"}]}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/rules \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"relation":"AND","conditions":[{"question":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"type":"ONE_OF","values":[{"option":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"operator":"GT","value":12}]}],"action":{"questions":[{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"}]}}

Example response

{
  "id": "11120324-a0b9-11e8-98d0-529269fb1459",
  "relation": "AND",
  "conditions": [
    {
      "question": {
        "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
      },
      "type": "ONE_OF",
      "values": [
        {
          "option": {
            "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
          },
          "operator": "GT",
          "value": 12
        }
      ]
    }
  ],
  "action": {
    "questions": [
      {
        "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
      }
    ]
  }
}

POST /pha-definitions/{phaDefinitionId}/rules

Creates a new rule for a PHA definition. A rule defines the logic used to customize and control the behavior of a PHA such as displaying or not displaying questions based on a respondent’s answers.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created PhaRule
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Delete a PHA Rule

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/rules/11120324-a0b9-11e8-98d0-529269fb1459', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/rules/11120324-a0b9-11e8-98d0-529269fb1459 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /pha-definitions/{phaDefinitionId}/rules/{ruleId}

Deletes a PHA rule for a PHA definition.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
ruleId path string true N/A The ID of the PHA rule. -

Response Statuses

Status Meaning Description Schema
204 No Content Deleted None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Update a PHA Rule

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/rules/11120324-a0b9-11e8-98d0-529269fb1459', headers: headers, body: {"relation":"AND","conditions":[{"question":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"type":"ONE_OF","values":[{"option":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"operator":"GT","value":12}]}],"action":{"questions":[{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"}]}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/rules/11120324-a0b9-11e8-98d0-529269fb1459 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"relation":"AND","conditions":[{"question":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"type":"ONE_OF","values":[{"option":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"operator":"GT","value":12}]}],"action":{"questions":[{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"}]}}

PUT /pha-definitions/{phaDefinitionId}/rules/{ruleId}

Updates a PHA rule for a PHA definition.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
ruleId path string true N/A The ID of the PHA rule. -
body body putPhaDefinitionsPhadefinitionidRules true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content Updated None
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single PHA Rule

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/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/rules/11120324-a0b9-11e8-98d0-529269fb1459', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-definitions/e61dd2fa-702d-11e9-a923-1681be663d3e/rules/11120324-a0b9-11e8-98d0-529269fb1459 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "11120324-a0b9-11e8-98d0-529269fb1459",
  "relation": "AND",
  "conditions": [
    {
      "question": {
        "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
      },
      "type": "ONE_OF",
      "values": [
        {
          "option": {
            "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
          },
          "operator": "GT",
          "value": 12
        }
      ]
    }
  ],
  "action": {
    "questions": [
      {
        "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
      }
    ]
  }
}

GET /pha-definitions/{phaDefinitionId}/rules/{ruleId}

Retrieves a single PHA rule for a PHA definition.

Parameters

Parameter In Type Required Default Description Accepted Values
phaDefinitionId path string true N/A The ID of the PHA definition. -
ruleId path string true N/A The ID of the PHA rule. -

Response Statuses

Status Meaning Description Schema
200 OK Success PhaRule
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Create a Published Personal Health Assessment

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/wellness/v1/published-personal-health-assessments', headers: headers, body: {"phaDefinition":{"id":"e61dd2fa-702d-11e9-a923-1681be663d3e"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/published-personal-health-assessments \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"phaDefinition":{"id":"e61dd2fa-702d-11e9-a923-1681be663d3e"}}

Example response

{
  "id": "ace20324-a0b9-11e8-98d0-529269fb1459"
}

POST /published-personal-health-assessments

Creates a new published personal health assessment. A published personal health assessment is a health assessment that is ready to be used in a production environment.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created PublishedPersonalHealthAssessment
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Retrieve a Single Published Personal Health Assessment

Example Request:


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

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

result = HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/published-personal-health-assessments/69c7f20d-a568-4bfd-ae0b-4475e0e2dd7f', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/published-personal-health-assessments/69c7f20d-a568-4bfd-ae0b-4475e0e2dd7f \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
  "phaDefinition": {
    "id": "e61dd2fa-702d-11e9-a923-1681be663d3e",
    "phaId": "ace20324-a0b9-11e8-98d0-529269fb1459",
    "name": "Cerner Demo Personal Health Assessment 2019",
    "locale": "en-US",
    "description": "Cerner Demo Personal Health Assessment 2019 is a wellness assessment to evaluate the overall physical and mental health of a person.",
    "code": {
      "system": "urn:ietf:rfc:3986",
      "code": "2-16-840-1-113883-6-1",
      "display": "Personal Health Assessment"
    },
    "sections": [
      {
        "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
        "name": "Nutrition",
        "description": "The nutritional assessment is an evaluation of dietary intake and nutrition status to identify the presence of malnutrition, obesity, and so on.",
        "position": 1,
        "code": {
          "system": "urn:ietf:rfc:3986",
          "code": "2-16-840-1-113883-6-1",
          "display": "Personal Health Assessment"
        },
        "questions": [
          {
            "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
            "text": "How many times do you eat junk food in a week?",
            "type": "RANGE",
            "description": "Junk food is food that is highly processed; high in calories, sugars, salt, and trans fat; and low in nutrients.",
            "acceptsMultipleAnswers": true,
            "required": true,
            "position": 1,
            "section": {
              "id": "12345678-120b-4c1e-81e4-3d3ae9c7580e"
            },
            "subsection": {
              "id": "9a7be4e4-5c65-11e9-8647-d663bd873d93"
            },
            "code": {
              "system": "urn:ietf:rfc:3986",
              "code": "2-16-840-1-113883-6-1",
              "display": "Personal Health Assessment"
            },
            "options": [
              {
                "id": "bce10324-a0b9-11e8-98d0-529269fb1459",
                "choice": {
                  "points": 5,
                  "text": "Between 1 and 25"
                },
                "range": {
                  "low": 1,
                  "high": 7,
                  "text": "Number of days in a week."
                }
              }
            ],
            "rule": {
              "id": "11120324-a0b9-11e8-98d0-529269fb1459",
              "relation": "AND",
              "conditions": [
                {
                  "question": {
                    "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
                  },
                  "type": "ONE_OF",
                  "values": [
                    {
                      "option": {
                        "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
                      },
                      "operator": "GT",
                      "value": 12
                    }
                  ]
                }
              ]
            }
          }
        ],
        "subsections": [
          {
            "id": "9a7be7c8-5c65-11e9-8647-d663bd873d93",
            "name": "Nutrition-Fats",
            "description": "Nutrition-Fats is the subset of nutrition questions that evaluates fats in the diet of *HealtheIntent* consumers.",
            "position": 1,
            "code": {
              "system": "urn:ietf:rfc:3986",
              "code": "2-16-840-1-113883-6-1",
              "display": "Personal Health Assessment"
            },
            "section": {
              "id": "12345678-120b-4c1e-81e4-3d3ae9c7580e"
            },
            "questions": [
              {
                "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
                "text": "How many times do you eat junk food in a week?",
                "type": "RANGE",
                "description": "Junk food is food that is highly processed; high in calories, sugars, salt, and trans fat; and low in nutrients.",
                "acceptsMultipleAnswers": true,
                "required": true,
                "position": 1,
                "section": {
                  "id": "12345678-120b-4c1e-81e4-3d3ae9c7580e"
                },
                "subsection": {
                  "id": "9a7be4e4-5c65-11e9-8647-d663bd873d93"
                },
                "code": {
                  "system": "urn:ietf:rfc:3986",
                  "code": "2-16-840-1-113883-6-1",
                  "display": "Personal Health Assessment"
                },
                "options": [
                  {
                    "id": "bce10324-a0b9-11e8-98d0-529269fb1459",
                    "choice": {
                      "points": 5,
                      "text": "Between 1 and 25"
                    },
                    "range": {
                      "low": 1,
                      "high": 7,
                      "text": "Number of days in a week."
                    }
                  }
                ],
                "rule": {
                  "id": "11120324-a0b9-11e8-98d0-529269fb1459",
                  "relation": "AND",
                  "conditions": [
                    {
                      "question": {
                        "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
                      },
                      "type": "ONE_OF",
                      "values": [
                        {
                          "option": {
                            "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
                          },
                          "operator": "GT",
                          "value": 12
                        }
                      ]
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

GET /published-personal-health-assessments/{publishedPersonalHealthAssessmentId}

Retrieves a single published personal health assessment.

Parameters

Parameter In Type Required Default Description Accepted Values
publishedPersonalHealthAssessmentId path string true N/A The ID of the published PHA. -

Response Statuses

Status Meaning Description Schema
200 OK Success PublishedPersonalHealthAssessment
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a List of PHA Risk Types

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/wellness/v1/pha-risk-types', headers: headers)

print JSON.pretty_generate(result)


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

Example response

{
  "items": [
    {
      "id": "11120324-a0b9-11e8-98d0-529269fb1459",
      "name": "Physical Activity Risk",
      "text": "Risk of physical Inactivity (lack of physical activity)",
      "code": {
        "system": "urn:ietf:rfc:3986",
        "code": "2-16-840-1-113883-6-1",
        "display": "Personal Health Assessment"
      }
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-risk-types?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-risk-types?offset=0&limit=20"
}

GET /pha-risk-types

Retrieves a list of all the available PHA risk types. A PHA risk type is a type of the risk assessment to be performed on the PHA Response.

Parameters

Parameter In Type Required Default Description Accepted Values
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 Success PhaRiskTypes
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Create a PHA Risk Type

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/wellness/v1/pha-risk-types', headers: headers, body: {"name":"Physical Activity Risk","text":"Risk of physical Inactivity (lack of physical activity)","code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-risk-types \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Physical Activity Risk","text":"Risk of physical Inactivity (lack of physical activity)","code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}

Example response

{
  "id": "11120324-a0b9-11e8-98d0-529269fb1459",
  "name": "Physical Activity Risk",
  "text": "Risk of physical Inactivity (lack of physical activity)",
  "code": {
    "system": "urn:ietf:rfc:3986",
    "code": "2-16-840-1-113883-6-1",
    "display": "Personal Health Assessment"
  }
}

POST /pha-risk-types

Creates a new PHA risk type for a PHA. A PHA risk type is a type of the risk assessment to be performed on the PHA Response.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created PhaRiskType
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Delete a PHA Risk Type

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/wellness/v1/pha-risk-types/9a7be7c8-5c65-11e9-8647-d663bd873d93', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-risk-types/9a7be7c8-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /pha-risk-types/{phaRiskTypeId}

Deletes a PHA risk type by ID. A PHA risk type is a type of the risk assessment to be performed on the PHA Response.

Parameters

Parameter In Type Required Default Description Accepted Values
phaRiskTypeId path string true N/A The ID of the risk type. -

Response Statuses

Status Meaning Description Schema
204 No Content Deleted None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Update a PHA Risk Type

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/wellness/v1/pha-risk-types/9a7be7c8-5c65-11e9-8647-d663bd873d93', headers: headers, body: {"name":"Physical Activity Risk","text":"Risk of physical Inactivity (lack of physical activity)","code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-risk-types/9a7be7c8-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Physical Activity Risk","text":"Risk of physical Inactivity (lack of physical activity)","code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}

PUT /pha-risk-types/{phaRiskTypeId}

Updates a PHA risk type by ID. A PHA risk type is a type of the risk assessment to be performed on the PHA Response.

Parameters

Parameter In Type Required Default Description Accepted Values
phaRiskTypeId path string true N/A The ID of the risk type. -
body body putPhaRiskTypes true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content Updated None
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single PHA Risk Type

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/wellness/v1/pha-risk-types/9a7be7c8-5c65-11e9-8647-d663bd873d93', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-risk-types/9a7be7c8-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "11120324-a0b9-11e8-98d0-529269fb1459",
  "name": "Physical Activity Risk",
  "text": "Risk of physical Inactivity (lack of physical activity)",
  "code": {
    "system": "urn:ietf:rfc:3986",
    "code": "2-16-840-1-113883-6-1",
    "display": "Personal Health Assessment"
  }
}

GET /pha-risk-types/{phaRiskTypeId}

Retrieves a single PHA risk type by ID. A PHA risk type is a type of the risk assessment to be performed on the PHA Response.

Parameters

Parameter In Type Required Default Description Accepted Values
phaRiskTypeId path string true N/A The ID of the risk type. -

Response Statuses

Status Meaning Description Schema
200 OK Success PhaRiskType
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a List of PHA Risk Interpretations

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/wellness/v1/pha-risk-interpretations', headers: headers)

print JSON.pretty_generate(result)


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

Example response

{
  "items": [
    {
      "id": "11120324-a0b9-11e8-98d0-529269fb1459",
      "text": "You are following recommendations for preventative health screenings and immunizations.",
      "name": "Preventive Health - Low Risk",
      "code": {
        "system": "urn:ietf:rfc:3986",
        "code": "2-16-840-1-113883-6-1",
        "display": "Personal Health Assessment"
      }
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-risk-interpretation?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-risk-interpretation?offset=0&limit=20"
}

GET /pha-risk-interpretations

Retrieves a list of all the available PHA risk interpretations. A PHA risk interpretation is an interpretation of the points that can be scored on the PHA Section or the PHA Subsection.

Parameters

Parameter In Type Required Default Description Accepted Values
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 Success PhaRiskInterpretations
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Create a PHA Risk Interpretation

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/wellness/v1/pha-risk-interpretations', headers: headers, body: {"text":"You are following recommendations for preventative health screenings and immunizations.","name":"Preventive Health - Low Risk","code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-risk-interpretations \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"text":"You are following recommendations for preventative health screenings and immunizations.","name":"Preventive Health - Low Risk","code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}

Example response

{
  "id": "11120324-a0b9-11e8-98d0-529269fb1459",
  "text": "You are following recommendations for preventative health screenings and immunizations.",
  "name": "Preventive Health - Low Risk",
  "code": {
    "system": "urn:ietf:rfc:3986",
    "code": "2-16-840-1-113883-6-1",
    "display": "Personal Health Assessment"
  }
}

POST /pha-risk-interpretations

Creates a new PHA risk interpretation for a PHA. A PHA risk interpretation is an interpretation of the points that can be scored on the PHA Section or the PHA Subsection.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created PhaRiskInterpretation
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Delete a PHA Risk Interpretation

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/wellness/v1/pha-risk-interpretations/9a7be7c8-5c65-11e9-8647-d663bd873d93', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-risk-interpretations/9a7be7c8-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /pha-risk-interpretations/{phaRiskInterpretationId}

Deletes a PHA risk interpretation by ID. A PHA risk interpretation is an interpretation of the points that can be scored on the PHA Section or the PHA Subsection.

Parameters

Parameter In Type Required Default Description Accepted Values
phaRiskInterpretationId path string true N/A The ID of the risk interpretation. -

Response Statuses

Status Meaning Description Schema
204 No Content Deleted None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Update a PHA Risk Interpretation

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/wellness/v1/pha-risk-interpretations/9a7be7c8-5c65-11e9-8647-d663bd873d93', headers: headers, body: {"text":"You are following recommendations for preventative health screenings and immunizations.","name":"Preventive Health - Low Risk","code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-risk-interpretations/9a7be7c8-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"text":"You are following recommendations for preventative health screenings and immunizations.","name":"Preventive Health - Low Risk","code":{"system":"urn:ietf:rfc:3986","code":"2-16-840-1-113883-6-1","display":"Personal Health Assessment"}}

PUT /pha-risk-interpretations/{phaRiskInterpretationId}

Updates a PHA risk interpretation by ID. A PHA risk interpretation is an interpretation of the points that can be scored on the PHA Section or the PHA Subsection.

Parameters

Parameter In Type Required Default Description Accepted Values
phaRiskInterpretationId path string true N/A The ID of the risk interpretation. -
body body putPhaRiskInterpretations true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content Updated None
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single PHA Risk Interpretation

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/wellness/v1/pha-risk-interpretations/9a7be7c8-5c65-11e9-8647-d663bd873d93', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-risk-interpretations/9a7be7c8-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "11120324-a0b9-11e8-98d0-529269fb1459",
  "text": "You are following recommendations for preventative health screenings and immunizations.",
  "name": "Preventive Health - Low Risk",
  "code": {
    "system": "urn:ietf:rfc:3986",
    "code": "2-16-840-1-113883-6-1",
    "display": "Personal Health Assessment"
  }
}

GET /pha-risk-interpretations/{phaRiskInterpretationId}

Retrieves a single PHA risk interpretation by ID. A PHA risk interpretation is an interpretation of the points that can be scored on the PHA Section or the PHA Subsection.

Parameters

Parameter In Type Required Default Description Accepted Values
phaRiskInterpretationId path string true N/A The ID of the risk interpretation. -

Response Statuses

Status Meaning Description Schema
200 OK Success PhaRiskInterpretation
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a List of PHA Response 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/wellness/v1/pha-response-definitions', headers: headers)

print JSON.pretty_generate(result)


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

Example response

{
  "items": [
    {
      "id": "e3e44e50-5c65-11e9-8647-d663bd873d93",
      "authoredAt": "2018-07-16T19:20:00+01:00",
      "publishedPhaDefinition": {
        "id": "6091627d-b20b-4c1e-81e4-3d3ae9c7580e",
        "name": "Cerner Demo Personal Health Assessment 2019"
      },
      "consumer": {
        "id": "08f464c0-4ce1-4cec-8e3c-9107ea17a1d7"
      },
      "completedPhaResponses": [
        {
          "id": "cf98baee-c461-11e9-aa8c-2a2ae2dbcce4",
          "authoredAt": "2018-07-16T19:20:00+01:00"
        }
      ]
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions?offset=0&limit=20"
}

GET /pha-response-definitions

Retrieves a list of all the available PHA Response Definitions.

Parameters

Parameter In Type Required Default Description Accepted Values
phaId query string false N/A Filters by the ID of a PHA. -
phaDefinitionId query string false N/A Filters by the ID of a PHA definition. -
consumerId query string false N/A Filters by the ID of a HealtheIntent consumer. -
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 Success. PhaResponseDefinitions
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Create a PHA Response 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/wellness/v1/pha-response-definitions', headers: headers, body: {"authoredAt":"2018-07-16T19:20:00+01:00","consumer":{"id":"08f464c0-4ce1-4cec-8e3c-9107ea17a1d7"},"phaDefinition":{"id":"6091627d-b20b-4c1e-81e4-3d3ae9c7580e","name":"Cerner Demo Personal Health Assessment 2019"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"authoredAt":"2018-07-16T19:20:00+01:00","consumer":{"id":"08f464c0-4ce1-4cec-8e3c-9107ea17a1d7"},"phaDefinition":{"id":"6091627d-b20b-4c1e-81e4-3d3ae9c7580e","name":"Cerner Demo Personal Health Assessment 2019"}}

Example response

{
  "id": "e3e44e50-5c65-11e9-8647-d663bd873d93",
  "authoredAt": "2018-07-16T19:20:00+01:00",
  "publishedPhaDefinition": {
    "id": "6091627d-b20b-4c1e-81e4-3d3ae9c7580e",
    "name": "Cerner Demo Personal Health Assessment 2019"
  },
  "consumer": {
    "id": "08f464c0-4ce1-4cec-8e3c-9107ea17a1d7"
  },
  "completedPhaResponses": [
    {
      "id": "cf98baee-c461-11e9-aa8c-2a2ae2dbcce4",
      "authoredAt": "2018-07-16T19:20:00+01:00"
    }
  ]
}

POST /pha-response-definitions

Creates a new PHA response definition. A PHA response is a set of answers given by a HealtheIntent consumer to the questions presented in a PHA. Use this endpoint the first time a consumer starts a new published PHA.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created PhaResponseDefinition
400 Bad Request Bad Request. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- PhaDefinitionNotFound The PHA definition specified for the response does not exist.
BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Delete a PHA Response 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/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /pha-response-definitions/{phaResponseDefinitionId}

Deletes a PHA response definition.

Parameters

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

Response Statuses

Status Meaning Description Schema
204 No Content Deleted None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Update a PHA Response 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/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93', headers: headers, body: {"authoredAt":"2018-07-16T19:20:00+01:00","consumer":{"id":"08f464c0-4ce1-4cec-8e3c-9107ea17a1d7"},"phaDefinition":{"id":"6091627d-b20b-4c1e-81e4-3d3ae9c7580e","name":"Cerner Demo Personal Health Assessment 2019"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"authoredAt":"2018-07-16T19:20:00+01:00","consumer":{"id":"08f464c0-4ce1-4cec-8e3c-9107ea17a1d7"},"phaDefinition":{"id":"6091627d-b20b-4c1e-81e4-3d3ae9c7580e","name":"Cerner Demo Personal Health Assessment 2019"}}

PUT /pha-response-definitions/{phaResponseDefinitionId}

Updates a PHA response definition.

Parameters

Parameter In Type Required Default Description Accepted Values
phaResponseDefinitionId path string true N/A The ID of the PHA response definition. -
body body putPhaResponseDefinitions true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content Updated None
400 Bad Request Bad Request. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- PhaDefinitionNotFound The PHA definition specified for the response does not exist.
BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single PHA Response 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/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "e3e44e50-5c65-11e9-8647-d663bd873d93",
  "authoredAt": "2018-07-16T19:20:00+01:00",
  "publishedPhaDefinition": {
    "id": "6091627d-b20b-4c1e-81e4-3d3ae9c7580e",
    "name": "Cerner Demo Personal Health Assessment 2019"
  },
  "consumer": {
    "id": "08f464c0-4ce1-4cec-8e3c-9107ea17a1d7"
  },
  "completedPhaResponses": [
    {
      "id": "cf98baee-c461-11e9-aa8c-2a2ae2dbcce4",
      "authoredAt": "2018-07-16T19:20:00+01:00"
    }
  ]
}

GET /pha-response-definitions/{phaResponseDefinitionId}

Retrieves a single PHA response definition.

Parameters

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

Response Statuses

Status Meaning Description Schema
200 OK Success PhaResponseDefinition
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a List of PHA Response Sections

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/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-sections', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-sections \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "9a7bdd28-5c65-11e9-8647-d663bd873d93",
      "section": {
        "id": "12345678-120b-4c1e-81e4-3d3ae9c7580e"
      },
      "status": "COMPLETED",
      "answers": [
        {
          "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
          "question": {
            "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
          },
          "values": [
            {
              "option": {
                "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
              },
              "value": "3"
            }
          ]
        }
      ]
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-sections?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-sections?offset=0&limit=20"
}

GET /pha-response-definitions/{phaResponseDefinitionId}/response-sections

Retrieves a list of all of the available PHA response sections.

Parameters

Parameter In Type Required Default Description Accepted Values
phaResponseDefinitionId path string true N/A The ID of the PHA response definition. -
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 Success PhaResponseSections
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Create a PHA Response Section

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/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-sections', headers: headers, body: {"status":"COMPLETED","section":{"id":"12345678-120b-4c1e-81e4-3d3ae9c7580e"},"answers":[{"id":"ace20324-a0b9-11e8-98d0-529269fb1459","question":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"values":[{"option":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"value":"3"}]}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-sections \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"status":"COMPLETED","section":{"id":"12345678-120b-4c1e-81e4-3d3ae9c7580e"},"answers":[{"id":"ace20324-a0b9-11e8-98d0-529269fb1459","question":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"values":[{"option":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"value":"3"}]}]}

Example response

{
  "id": "9a7bdd28-5c65-11e9-8647-d663bd873d93",
  "section": {
    "id": "12345678-120b-4c1e-81e4-3d3ae9c7580e"
  },
  "status": "COMPLETED",
  "answers": [
    {
      "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
      "question": {
        "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
      },
      "values": [
        {
          "option": {
            "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
          },
          "value": "3"
        }
      ]
    }
  ]
}

POST /pha-response-definitions/{phaResponseDefinitionId}/response-sections

Creates a new PHA response section for a PHA response. A PHA response section is a structured group that contains answers to questions in a particular section of a PHA.

Parameters

Parameter In Type Required Default Description Accepted Values
phaResponseDefinitionId path string true N/A The ID of the PHA response definition. -
body body postPhaResponseDefinitionsPharesponsedefinitionidResponseSections true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created Created PhaResponseSection
400 Bad Request Bad Request. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- PhaSectionNotFound The PHA section specified for the response section does not exist.
- PhaQuestionNotFound The PHA question specified for the answer does not exist in the section.
- OptionNotFound The option specified in the answer does not exist.
- InvalidValue The value specified in the answer is not valid for the type of the question.
- ValueNotInRange The value specified in the answer is not within the range specified by the question.
BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Delete a PHA Response Section

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/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-sections/9a7bdd28-5c65-11e9-8647-d663bd873d93', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-sections/9a7bdd28-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /pha-response-definitions/{phaResponseDefinitionId}/response-sections/{responseSectionId}

Deletes a PHA response section for a PHA response.

Parameters

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

Response Statuses

Status Meaning Description Schema
204 No Content Deleted None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Update a PHA Response Section

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/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-sections/9a7bdd28-5c65-11e9-8647-d663bd873d93', headers: headers, body: {"status":"COMPLETED","section":{"id":"12345678-120b-4c1e-81e4-3d3ae9c7580e"},"answers":[{"id":"ace20324-a0b9-11e8-98d0-529269fb1459","question":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"values":[{"option":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"value":"3"}]}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-sections/9a7bdd28-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"status":"COMPLETED","section":{"id":"12345678-120b-4c1e-81e4-3d3ae9c7580e"},"answers":[{"id":"ace20324-a0b9-11e8-98d0-529269fb1459","question":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"values":[{"option":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"value":"3"}]}]}

PUT /pha-response-definitions/{phaResponseDefinitionId}/response-sections/{responseSectionId}

Updates a PHA response section for a PHA response.

Parameters

Parameter In Type Required Default Description Accepted Values
phaResponseDefinitionId path string true N/A The ID of the PHA response definition. -
responseSectionId path string true N/A The ID of the PHA response section. -
body body putPhaResponseDefinitionsPharesponsedefinitionidResponseSections true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content Updated None
400 Bad Request Bad Request. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- PhaSectionNotFound The PHA section specified for the response section does not exist.
- PhaQuestionNotFound The PHA question specified for the answer does not exist in the section.
- OptionNotFound The option specified in the answer does not exist.
- InvalidValue The value specified in the answer is not valid for the type of the question.
- ValueNotInRange The value specified in the answer is not within the range specified by the question.
BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single PHA Response Section

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/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-sections/9a7bdd28-5c65-11e9-8647-d663bd873d93', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-sections/9a7bdd28-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "9a7bdd28-5c65-11e9-8647-d663bd873d93",
  "section": {
    "id": "12345678-120b-4c1e-81e4-3d3ae9c7580e"
  },
  "status": "COMPLETED",
  "answers": [
    {
      "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
      "question": {
        "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
      },
      "values": [
        {
          "option": {
            "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
          },
          "value": "3"
        }
      ]
    }
  ]
}

GET /pha-response-definitions/{phaResponseDefinitionId}/response-sections/{responseSectionId}

Retrieves a single PHA response section for a PHA response.

Parameters

Parameter In Type Required Default Description Accepted Values
phaResponseDefinitionId path string true N/A The ID of the PHA response definition. -
responseSectionId path string true N/A The ID of the PHA response section. -

Response Statuses

Status Meaning Description Schema
200 OK Success PhaResponseSection
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a List of PHA Response Subsections

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/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-subsections', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-subsections \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "9a7be688-5c65-11e9-8647-d663bd873d93",
      "status": "COMPLETED",
      "subsection": {
        "id": "9a7be4e4-5c65-11e9-8647-d663bd873d93"
      },
      "answers": [
        {
          "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
          "question": {
            "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
          },
          "values": [
            {
              "option": {
                "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
              },
              "value": "3"
            }
          ]
        }
      ]
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-subsections?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-subsections?offset=0&limit=20"
}

GET /pha-response-definitions/{phaResponseDefinitionId}/response-subsections

Retrieves a list of all the available PHA response subsections for a PHA response.

Parameters

Parameter In Type Required Default Description Accepted Values
phaResponseDefinitionId path string true N/A The ID of the PHA response definition. -
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 Success. PhaResponseSubsections
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Create a PHA Response Subsection

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/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-subsections', headers: headers, body: {"subsection":{"id":"9a7be4e4-5c65-11e9-8647-d663bd873d93"},"status":"COMPLETED","answers":[{"id":"ace20324-a0b9-11e8-98d0-529269fb1459","question":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"values":[{"option":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"value":"3"}]}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-subsections \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"subsection":{"id":"9a7be4e4-5c65-11e9-8647-d663bd873d93"},"status":"COMPLETED","answers":[{"id":"ace20324-a0b9-11e8-98d0-529269fb1459","question":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"values":[{"option":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"value":"3"}]}]}

Example response

{
  "id": "9a7be688-5c65-11e9-8647-d663bd873d93",
  "status": "COMPLETED",
  "subsection": {
    "id": "9a7be4e4-5c65-11e9-8647-d663bd873d93"
  },
  "answers": [
    {
      "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
      "question": {
        "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
      },
      "values": [
        {
          "option": {
            "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
          },
          "value": "3"
        }
      ]
    }
  ]
}

POST /pha-response-definitions/{phaResponseDefinitionId}/response-subsections

Creates a new PHA response subsection for a PHA response. A PHA response subsection is a structured group that contains answers to questions in a particular subsection of a PHA.

Parameters

Parameter In Type Required Default Description Accepted Values
phaResponseDefinitionId path string true N/A The ID of the PHA response definition. -
body body postPhaResponseDefinitionsPharesponsedefinitionidResponseSubsections true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created Created PhaResponseSubsection
400 Bad Request Bad Request. The response includes error details with a reason field that can help identify the issue. The following reasons are possible, among others:
- PhaSubsectionNotFound The PHA subsection specified for the response subsection does not exist.
- PhaQuestionNotFound The PHA question specified for the answer does not exist in the subsection.
- OptionNotFound The option specified in the answer does not exist.
- InvalidValue The value specified in the answer is not valid for the type of the question.
- ValueNotInRange The value specified in the answer is not within the range specified by the question.
BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Delete a PHA Response Subsection

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/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-subsections/9a7bdd28-5c65-11e9-8647-d663bd873d93', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-subsections/9a7bdd28-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /pha-response-definitions/{phaResponseDefinitionId}/response-subsections/{responseSubsectionId}

Deletes a PHA response subsection for a PHA response.

Parameters

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

Response Statuses

Status Meaning Description Schema
204 No Content Deleted None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Update a PHA Response Subsection

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/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-subsections/9a7bdd28-5c65-11e9-8647-d663bd873d93', headers: headers, body: {"subsection":{"id":"9a7be4e4-5c65-11e9-8647-d663bd873d93"},"status":"COMPLETED","answers":[{"id":"ace20324-a0b9-11e8-98d0-529269fb1459","question":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"values":[{"option":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"value":"3"}]}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-subsections/9a7bdd28-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"subsection":{"id":"9a7be4e4-5c65-11e9-8647-d663bd873d93"},"status":"COMPLETED","answers":[{"id":"ace20324-a0b9-11e8-98d0-529269fb1459","question":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"values":[{"option":{"id":"12865678-120b-4c1e-81e4-3d3ae9c7580e"},"value":"3"}]}]}

PUT /pha-response-definitions/{phaResponseDefinitionId}/response-subsections/{responseSubsectionId}

Updates a PHA response subsection for a PHA response.

Parameters

Parameter In Type Required Default Description Accepted Values
phaResponseDefinitionId path string true N/A The ID of the PHA response definition. -
responseSubsectionId path string true N/A The ID of the PHA response subsection. -
body body putPhaResponseDefinitionsPharesponsedefinitionidResponseSubsections true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content Updated. None
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single PHA Response Subsection

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/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-subsections/9a7bdd28-5c65-11e9-8647-d663bd873d93', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/pha-response-definitions/e3e44e50-5c65-11e9-8647-d663bd873d93/response-subsections/9a7bdd28-5c65-11e9-8647-d663bd873d93 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "9a7be688-5c65-11e9-8647-d663bd873d93",
  "status": "COMPLETED",
  "subsection": {
    "id": "9a7be4e4-5c65-11e9-8647-d663bd873d93"
  },
  "answers": [
    {
      "id": "ace20324-a0b9-11e8-98d0-529269fb1459",
      "question": {
        "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
      },
      "values": [
        {
          "option": {
            "id": "12865678-120b-4c1e-81e4-3d3ae9c7580e"
          },
          "value": "3"
        }
      ]
    }
  ]
}

GET /pha-response-definitions/{phaResponseDefinitionId}/response-subsections/{responseSubsectionId}

Retrieves a single PHA response subsection for a PHA response.

Parameters

Parameter In Type Required Default Description Accepted Values
phaResponseDefinitionId path string true N/A The ID of the PHA response definition. -
responseSubsectionId path string true N/A The ID of the PHA response subsection. -

Response Statuses

Status Meaning Description Schema
200 OK Success PhaResponseSubsection
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Create a Completed PHA Response

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/wellness/v1/completed-pha-responses', headers: headers, body: {"phaResponse":{"id":"e3e44e50-5c65-11e9-8647-d663bd873d93"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/completed-pha-responses \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"phaResponse":{"id":"e3e44e50-5c65-11e9-8647-d663bd873d93"}}

Example response

{
  "id": "a364d8d2-9da5-4188-aed2-252e81b4d976",
  "phaResponseDefinition": {
    "id": "e3e44e50-5c65-11e9-8647-d663bd873d93"
  }
}

POST /completed-pha-responses

Creates a new completed PHA response. A completed PHA response is a response to a published health assessment that is marked as complete by the HealtheIntent consumer and is ready for further processing such as risk assessment and health and wellness activity assignments. Use this endpoint every time a consumer submits a PHA response.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created CompletedPhaResponse
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Retrieve a Single Completed PHA Response

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/wellness/v1/completed-pha-responses/a364d8d2-9da5-4188-aed2-252e81b4d976', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/completed-pha-responses/a364d8d2-9da5-4188-aed2-252e81b4d976 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "a364d8d2-9da5-4188-aed2-252e81b4d976",
  "phaResponseDefinition": {
    "id": "e3e44e50-5c65-11e9-8647-d663bd873d93"
  }
}

GET /completed-pha-responses/{completedPhaResponseId}

Retrieves a single completed PHA response.

Parameters

Parameter In Type Required Default Description Accepted Values
completedPhaResponseId path string true N/A The ID of the completed PHA response. -

Response Statuses

Status Meaning Description Schema
200 OK Success CompletedPhaResponse
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Wellness Screening Results

Wellness screening results are a feature that includes a defined set of observations used to determine areas of risk for a wellness member.

Retrieve a List of Completion Criteria

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/wellness/v1/screening-results-completion-criteria', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/screening-results-completion-criteria \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "da799f06-5f53-41cb-9335-4cd291b91578",
      "code": {
        "code": "2085-9",
        "system": "2.16.840.1.113883.6.1"
      }
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/screening-results-completion-criteria?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/screening-results-completion-criteria?offset=0&limit=20"
}

GET /screening-results-completion-criteria

Retrieves all of the available completion criteria for a HealtheIntent tenant.

Parameters

Parameter In Type Required Default Description Accepted Values
code query string false N/A Filters by the system and value of the code. Use URL encoding, separate the system and value with a : (%3A when URL-encoded), and use the following format: [code system]%3A[code value]. See the following example: ?code=SNOWMED%3A20034578. -
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 Success. CompletionCriterions
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Create a Completion Criterion

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/wellness/v1/screening-results-completion-criteria', headers: headers, body: {"code":{"code":"2085-9","system":"2.16.840.1.113883.6.1"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/screening-results-completion-criteria \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"code":{"code":"2085-9","system":"2.16.840.1.113883.6.1"}}

POST /screening-results-completion-criteria

Creates a screening completion criterion for a HealtheIntent tenant. The screening results completion criteria define a set of observations required for awarding incentives.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created CompletionCriterion
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Delete a Completion Criterion

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/wellness/v1/screening-results-completion-criteria/ffadf1b7-b812-4eed-a769-f6a6c4c04b97', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/screening-results-completion-criteria/ffadf1b7-b812-4eed-a769-f6a6c4c04b97 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /screening-results-completion-criteria/{screeningResultsCompletionCriteriaId}

Deletes a single completion criterion for a HealtheIntent tenant.

Parameters

Parameter In Type Required Default Description Accepted Values
screeningResultsCompletionCriteriaId path string true N/A The ID of the completion criterion. -

Response Statuses

Status Meaning Description Schema
204 No Content Deleted None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Update a Completion Criterion

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/wellness/v1/screening-results-completion-criteria/ffadf1b7-b812-4eed-a769-f6a6c4c04b97', headers: headers, body: {"code":{"code":"2085-9","system":"2.16.840.1.113883.6.1"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/screening-results-completion-criteria/ffadf1b7-b812-4eed-a769-f6a6c4c04b97 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"code":{"code":"2085-9","system":"2.16.840.1.113883.6.1"}}

PUT /screening-results-completion-criteria/{screeningResultsCompletionCriteriaId}

Updates a single completion criterion for a HealtheIntent tenant.

Parameters

Parameter In Type Required Default Description Accepted Values
screeningResultsCompletionCriteriaId path string true N/A The ID of the completion criterion. -
body body putScreeningResultsCompletionCriteria true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content Success None
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single Completion Criterion

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/wellness/v1/screening-results-completion-criteria/ffadf1b7-b812-4eed-a769-f6a6c4c04b97', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/screening-results-completion-criteria/ffadf1b7-b812-4eed-a769-f6a6c4c04b97 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /screening-results-completion-criteria/{screeningResultsCompletionCriteriaId}

Retrieves a single completion criterion for a HealtheIntent tenant.

Parameters

Parameter In Type Required Default Description Accepted Values
screeningResultsCompletionCriteriaId path string true N/A The ID of the completion criterion. -

Response Statuses

Status Meaning Description Schema
200 OK Success CompletionCriterion
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Eligibility Records

Eligibility records contain information about the eligible wellness program members provided by a tenant.

Create Eligibility Records

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/wellness/v1/eligibility-records', headers: headers, body: {"eligibilityRecords":[{"consumer":{"id":"d13cf066-0e21-40c7-bd9e-e19467b2c85e"},"memberId":"38e3ac0d1221","dateOfBirth":"1996-02-28","familyName":"Smith","givenName":"Robert","middleName":"James","gender":"MALE","relationship":"PLAN_MEMBER","terminationDate":"2019-10-08","addresses":null,"telecoms":[{"system":"EMAIL","value":"robert.smith@rockhurst.edu"}],"memberGroup":"CER-MO","additionalInformation":[{"name":"companyDepartment","value":"Department of Education"}],"updatedBy":{"type":"SYSTEM","id":"ecb8026a-64f9-11e8-adc0-fa7ae01bbebc"}}],"consumer":{"id":"d13cf066-0e21-40c7-bd9e-e19467b2c85e"},"memberId":"38e3ac0d1221","dateOfBirth":"1996-02-28","familyName":"Smith","givenName":"Robert","middleName":"James","gender":"MALE","relationship":"PLAN_MEMBER","terminationDate":"2019-10-08","telecoms":[{"system":"EMAIL","value":"robert.smith@rockhurst.edu"}],"memberGroup":"CER-MO","additionalInformation":[{"name":"companyDepartment","value":"Department of Education"}],"updatedBy":{"type":"SYSTEM","id":"ecb8026a-64f9-11e8-adc0-fa7ae01bbebc"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/eligibility-records \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"eligibilityRecords":[{"consumer":{"id":"d13cf066-0e21-40c7-bd9e-e19467b2c85e"},"memberId":"38e3ac0d1221","dateOfBirth":"1996-02-28","familyName":"Smith","givenName":"Robert","middleName":"James","gender":"MALE","relationship":"PLAN_MEMBER","terminationDate":"2019-10-08","addresses":null,"telecoms":[{"system":"EMAIL","value":"robert.smith@rockhurst.edu"}],"memberGroup":"CER-MO","additionalInformation":[{"name":"companyDepartment","value":"Department of Education"}],"updatedBy":{"type":"SYSTEM","id":"ecb8026a-64f9-11e8-adc0-fa7ae01bbebc"}}],"consumer":{"id":"d13cf066-0e21-40c7-bd9e-e19467b2c85e"},"memberId":"38e3ac0d1221","dateOfBirth":"1996-02-28","familyName":"Smith","givenName":"Robert","middleName":"James","gender":"MALE","relationship":"PLAN_MEMBER","terminationDate":"2019-10-08","telecoms":[{"system":"EMAIL","value":"robert.smith@rockhurst.edu"}],"memberGroup":"CER-MO","additionalInformation":[{"name":"companyDepartment","value":"Department of Education"}],"updatedBy":{"type":"SYSTEM","id":"ecb8026a-64f9-11e8-adc0-fa7ae01bbebc"}}

POST /eligibility-records

Creates multiple eligibility records. This allows tenants to set up eligible wellness members. A maximum of 1000 eligibility records can be sent per request.

Parameters

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

Response Statuses

Status Meaning Description Schema
201 Created Created. EligibilityRecordList
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Retrieve a List of Eligibility Records

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/wellness/v1/eligibility-records', headers: headers)

print JSON.pretty_generate(result)


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

Example response

{
  "items": [
    {
      "id": "75323063-2b6d-4f80-b3ee-ab167d18c8b7",
      "consumer": {
        "id": "d13cf066-0e21-40c7-bd9e-e19467b2c85e"
      },
      "memberId": "38e3ac0d1221",
      "dateOfBirth": "1996-02-28",
      "familyName": "Smith",
      "givenName": "Robert",
      "middleName": "James",
      "gender": "MALE",
      "relationship": "PLAN_MEMBER",
      "terminationDate": "2019-10-08",
      "addresses": [
        {
          "use": "HOME",
          "text": "10236 Marion Park Dr, Kansas City, MO 64137",
          "lines": [
            "10236 Marion Park Dr"
          ],
          "city": "Kansas City",
          "state": "MO",
          "postalCode": "64137",
          "country": "USA"
        }
      ],
      "telecoms": [
        {
          "system": "EMAIL",
          "value": "robert.smith@rockhurst.edu"
        }
      ],
      "memberGroup": "CER-MO",
      "additionalInformation": [
        {
          "name": "companyDepartment",
          "value": "Department of Education"
        }
      ],
      "updatedBy": {
        "type": "SYSTEM",
        "id": "ecb8026a-64f9-11e8-adc0-fa7ae01bbebc"
      }
    }
  ],
  "totalResults": 1,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/eligibility-records?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/eligibility-records?offset=0&limit=20"
}

GET /eligibility-records

Retrieves all of the eligibility records that meet the specified parameters. This can be used to verify the identity of an eligible member.

Parameters

Parameter In Type Required Default Description Accepted Values
consumerId query string false N/A Filters by the consumer ID of an eligible member. -
telecom query string false N/A Filters by the system and value of the user’s telecom. Use a colon (:) to separate the system and value.

Note: The system and value must be URL-encoded, for example, ?telecom=EMAIL%3Auser%40cerner.com.
-
memberId query string false N/A Filters by the member ID of an eligible member. -
familyName query string false N/A Filters by the family name of an eligible member. -
givenName query string false N/A Filters by the given name of an eligible member. -
dateOfBirth query string false N/A Filters by the date of birth of an eligible member. -
memberGroup query string false N/A Filters by the member group of an eligible member. -
updatedBy query string false N/A Filters by the type and ID of a system or individual that created or updated an eligibility record. Use a colon (:) to separate the type and ID.

Note: The type and ID must be URL-encoded, for example, ?updatedBy=SYSTEM%3Aecb8026a-64f9-11e8-adc0-fa7ae01bbebc.
-
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 Success. EligibilityRecords
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError

Update an Eligibility Record

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/wellness/v1/eligibility-records/75323063-2b6d-4f80-b3ee-ab167d18c8b7', headers: headers, body: {"consumer":{"id":"d13cf066-0e21-40c7-bd9e-e19467b2c85e"},"memberId":"38e3ac0d1221","dateOfBirth":"1996-02-28","familyName":"Smith","givenName":"Robert","middleName":"James","gender":"MALE","relationship":"PLAN_MEMBER","terminationDate":"2019-10-08","telecoms":[{"system":"EMAIL","value":"robert.smith@rockhurst.edu"}],"memberGroup":"CER-MO","additionalInformation":[{"name":"companyDepartment","value":"Department of Education"}],"updatedBy":{"type":"SYSTEM","id":"ecb8026a-64f9-11e8-adc0-fa7ae01bbebc"}}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/eligibility-records/75323063-2b6d-4f80-b3ee-ab167d18c8b7 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"consumer":{"id":"d13cf066-0e21-40c7-bd9e-e19467b2c85e"},"memberId":"38e3ac0d1221","dateOfBirth":"1996-02-28","familyName":"Smith","givenName":"Robert","middleName":"James","gender":"MALE","relationship":"PLAN_MEMBER","terminationDate":"2019-10-08","telecoms":[{"system":"EMAIL","value":"robert.smith@rockhurst.edu"}],"memberGroup":"CER-MO","additionalInformation":[{"name":"companyDepartment","value":"Department of Education"}],"updatedBy":{"type":"SYSTEM","id":"ecb8026a-64f9-11e8-adc0-fa7ae01bbebc"}}

PUT /eligibility-records/{eligibilityRecordId}

Updates an eligibility record by ID.

Parameters

Parameter In Type Required Default Description Accepted Values
eligibilityRecordId path string true N/A The ID of the eligibility record. -
body body putEligibilityRecords true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content Updated. None
400 Bad Request Bad Request BadRequestError
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Delete an Eligibility Record

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/wellness/v1/eligibility-records/75323063-2b6d-4f80-b3ee-ab167d18c8b7', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/eligibility-records/75323063-2b6d-4f80-b3ee-ab167d18c8b7 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /eligibility-records/{eligibilityRecordId}

Deletes an eligibility record.

Parameters

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

Response Statuses

Status Meaning Description Schema
204 No Content Deleted. None
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Retrieve a Single Eligibility Record

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/wellness/v1/eligibility-records/75323063-2b6d-4f80-b3ee-ab167d18c8b7', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/wellness/v1/eligibility-records/75323063-2b6d-4f80-b3ee-ab167d18c8b7 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

GET /eligibility-records/{eligibilityRecordId}

Retrieves a single eligibility record by its ID. This can be used to retrieve information for an eligibility record.

Parameters

Parameter In Type Required Default Description Accepted Values
eligibilityRecordId path string true N/A The ID of the eligibility record. -

Response Statuses

Status Meaning Description Schema
200 OK Success. EligibilityRecord
401 Unauthorized Unauthorized UnauthorizedError
403 Forbidden Forbidden ForbiddenError
404 Not Found Not Found NotFoundError

Schema Definitions

postCampaignDefinitions

Name Type Required Description Accepted Values
names [string] true A list of campaign names for the different locales. -
descriptions [string] false A list of campaign descriptions for the different locales. -
gracePeriodEndsAt string false The date and time until which a member can continue to submit completed data and activities and still earn incentives points after a campaign ends, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. Must be later than the campaign endsAt date. -
startsAt string true The date and time when the campaign starts, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
endsAt string true The date and time when the campaign ends, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
reward object false The reward the consumer earns when the objective is completed. -
» id string true The ID of the reward. -
completionThreshold integer(int32) false The minimum number of objectives that the consumer needs to complete to complete the category. -
adjustmentReward object false The reward that is used to make points adjustments to the category. If reward is specified, this must also be specified. -
» id string true The ID of the reward. -
timeZone string true The time zone in which this campaign is created. -
icon string false The file name of the icon. -
populations [object] false The populations associated with the campaign. -
» populationId string true The ID of the population. -
» dataPartitionId string true The ID of the data partition. -

CampaignDefinition

Name Type Required Description Accepted Values
id string true The ID of the campaign. -
names [Translation] true The name of the campaign. -
descriptions [Translation] false The description of the campaign. -
categoryId string true The ID of the root category for the campaign. -
populations [Population] false The populations associated with the campaign. -
reward string false The ID of the maximum point definition for the campaign. -
adjustmentReward string false The reward that is used to make points adjustments to the category. If reward is specified, this must also be specified. -
completionThreshold integer(int32) false The minimum number of objectives that the consumer needs to complete to complete the category. -
icon string false The file name of the icon. -
gracePeriodEndsAt string false The date and time until which a member can continue to submit completed data and activities and still earn incentives points after a campaign ends, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. Must be later than the campaign endsAt date. -
startsAt string true The date and time when the campaign starts, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
endsAt string true The date and time when the campaign ends, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
timeZone string false The time zone in which this campaign is created. -
createdAt string false The date and time when the campaign was created, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
updatedAt string false The date and time when the campaign was last updated, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -

Translation

Name Type Required Description Accepted Values
locale string true A two-letter language and two-letter region ID, for example, en-US. The locale should match the ISO 639-1 specification. See ISO 639 Language Codes on the ISO website for more information. -
text string true The text for the locale. -

Population

Name Type Required Description Accepted Values
populationId string true The ID of the population. -
dataPartitionId string true The ID of the data partition. -

Unauthorized

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 [string] false A list of additional error details. -

Forbidden

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 [string] false A list of additional error details. -

BadRequest

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 [string] false A list of additional error details. -

CampaignDefinitions

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

NotFound

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 [string] false A list of additional error details. -

patchCampaignDefinitions

Name Type Required Description Accepted Values
names [string] false A list of campaign names for the different locales. -
descriptions [string] false A list of campaign descriptions for the different locales. -
gracePeriodEndsAt string false The date and time until which a member can continue to submit completed data and activities and still earn incentives points after a campaign ends, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. Must be later than the campaign endsAt date. -
startsAt string false The date and time when the campaign starts, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
endsAt string false The date and time when the campaign ends, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
reward object false The reward the consumer earns when the objective is completed. -
» id string true The ID of the reward. -
adjustmentReward object false The reward that is used to make points adjustments to the category. If reward is specified, this must also be specified. -
» id string true The ID of the reward. -
completionThreshold integer(int32) false The minimum number of objectives that the consumer needs to complete to complete the category. -
timeZone string false The time zone in which this campaign is created. -
icon string false The file name of the icon. -
populations [object] false A list of populations for the campaign. -
» populationId string true The ID of the population. -
» dataPartitionId string true The ID of the data partition. -

Conflict

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 [string] false A list of additional error details. -

postCampaignDefinitionsCampaignidCategoryDefinitions

Name Type Required Description Accepted Values
names [string] true A list of category names for the different locales. -
descriptions [string] false A list of category descriptions for the different locales. -
startsAt string true The date and time when the category starts, in ISO 8601 format. -
endsAt string true The date and time when the category ends, in ISO 8601 format. -
parentCategoryId string false The ID of the parent category. Categories can be nested up to three levels. -
icon string false The URL of the file name of the icon. -
reward object false The reward for maximum point definition. -
» id string true The ID of the reward. -
completionThreshold integer(int32) false The minimum number of objectives that the consumer needs to complete to complete the category. -
adjustmentReward object false The reward that is used to make points adjustments to the category. If reward is specified, this must also be specified. -
» id string true The ID of the reward. -
objectives [object] false The array of objectives. -
» id string true The ID of the objective. -

CampaignCategoryDefinition

Name Type Required Description Accepted Values
id string true The ID of the category. -
parentCategoryId string false The parent ID of the category. -
position integer(int32) false The numeric position of the category in relation to its siblings. -
names Translation true The name of the category. -
descriptions Translation true The description of the category. -
reward string false The reward for the maximum point definition for the category. -
adjustmentReward string false The reward that is used to make points adjustments for the category. -
completionThreshold integer(int32) false The completion threshold number for the category. -
icon string false The file name of the icon. -
startsAt string false The date and time when the category starts, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
endsAt string false The date and time when the category ends, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
objectives [ObjectiveId] false The list of objectives associated with the category. -
categories [CampaignCategoryDefinition] false The child categories associated with the category. -
createdAt string false The date and time when the category was created, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
updatedAt string false The date and time when the category was last updated, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -

ObjectiveId

Name Type Required Description Accepted Values
position integer(int32) true The position of the objective in its associated category. -
objectiveDefinitionId string true The ID of the objective definition. -

CampaignCategoryDefinitions

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

patchCampaignDefinitionsCampaignidCategoryDefinitions

Name Type Required Description Accepted Values
names [string] false A list of category names for the different locales. -
descriptions [string] false A list of category descriptions for the different locales. -
startsAt string false The date and time when the category starts, in ISO 8601 format. -
endsAt string false The date and time when the category ends, in ISO 8601 format. -
parentCategoryId string false The ID of the parent category. Categories can be nested up to three levels. -
position integer(int32) false The numeric position of the category in relation to its siblings. -
icon string false The URL of file name of the icon. -
reward object false The reward for maximum point definition. -
» id string true The ID of the reward. -
completionThreshold integer(int32) false The minimum number of objectives that the consumer needs to complete to complete the category. -
adjustmentReward object false The reward that is used to make points adjustments to the category. If reward is specified, this must also be specified. -
» id string true The ID of the reward. -
objectives [object] false The array of objectives. -
» id string true The ID of the objective. -

postCampaignDefinitionsCampaignidCategoryDefinitionsCategoryidObjectiveDefinitions

Name Type Required Description Accepted Values
titles [object] true A list of objective names for the different locales. -
» locale string true A two-letter language and two-letter region ID, for example, en-US. The locale should match the ISO 639-1 specification. See ISO 639 Language Codes on the ISO website for more information. -
» text string true The title of the objective for the specified locale. The maximum length is 191 characters. -
descriptions [object] false A list of objective descriptions for the different locales. -
» locale string true A two-letter language and two-letter region ID, for example, en-US. The locale should match the ISO 639-1 specification. See ISO 639 Language Codes on the ISO website for more information. -
» text string true The descriptions of the objective for the specified locale. The maximum length is 191 characters. -
sourceDefinition object true The source system in which the activity is defined. -
» id string false The ID of the source system -
» kind string true The type of the source system in which the activity is defined, for example, EDUCATION_MODULE or QUESTIONNAIRE. -
frequency string true How often the objective can be completed. DAILY, WEEKLY, MONTHLY, QUARTERLY, BI_ANNUALLY, ANNUALLY, ONE_TIME
isRepeatableWithinFrequency boolean true Indicates whether the objective can be completed multiple times within the objective frequency. -
requiresVerification boolean false Indicates whether the objective must be verified. When this is set to true, the objective must be verified and marked as complete by an administrator or care provider. -
startsAt string true The date and time when the objective starts, in ISO 8601 format. -
endsAt string true The date and time when the objective ends, in ISO 8601 format. -
maxCompletionCount integer(int32) false The maximum number of times this objective can be completed. This can be used only for completion-based objectives. -
primaryObjectiveId string false The ID of an existing valid objective. An objective with the primaryObjectiveId attribute is an alternative objective. -
sources [string] false The sources permitted to meet an objective. If this is not specified, all sources are permitted. SPECIFIC_PROVIDER, CLAIM, SELF_ENTERED, APP_DEVICE, COACH_ENTERED, ADMINISTRATOR_UPLOADED, EMR_DW_INTEGRATION
conditions [object] false A list of conditions for the objective. -
» value string false The value for the condition. -
» operator string false The conditional operator for the objective. If the consumerConditionType is GENDER or DIABETIC, the MATCHES operator must be used. If the consumerConditionType is AGE, one of the following operators must be used: [‘>’, ‘<’, ‘<=’, ‘>=’]. =, >, <, <=, >=, INCREASE_PERCENTAGE, DECREASE_PERCENTAGE, IMPROVE_PERCENTAGE, MATCHES
» target string false The target range of the objective. -
» subtype string false The subtype against which the condition type is compared, for example, SYSTOLIC or DIASTOLIC. -
» consumerConditionType string false The type of conditions related to consumer. AGE, GENDER, DIABETIC
codings [object] false The list of code systems referenced by the objective. -
» referenceId string true A reference to the coding system. This is either system<code>&#124;</code>code when the kind value is ontology#code or contextId<code>&#124;</code>alias when the kind value is ontology#concept. -
» kind string true The type of the coding system. -
reward object false The incentive reward for the objective. -
» id string true The ID of the reward. -
» limitPerFrequency string true The maximum number of times this reward can be given per frequency. -

Objective

Name Type Required Description Accepted Values
id string true The ID of the objective. -
position integer(int32) true The number position of the objective. -
titles [Translation] true The name of the objective. -
descriptions [Translation] false The description of the objective. -
sourceDefinition object false The source system in which the activity is defined. -
frequency string false The frequency of the objective. DAILY, WEEKLY, MONTHLY, QUARTERLY, BI_ANNUALLY, ANNUALLY, ONE_TIME
startsAt string true The date and time when the campaign starts, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
endsAt string true The date and time when the campaign ends, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
isRepeatableWithinFrequency boolean false Indicates whether the objective can be completed multiple times within the objective frequency. -
maxCompletionCount integer(int32) false The maximum number of times the objective can be completed over the entire period of the campaign. -
primaryObjectiveId string false The ID of an existing valid objective. An objective with the primaryObjectiveId attribute is an alternative objective. -
acceptsAllSources boolean false Indicates whether all sources are acceptable. -
requiresVerification boolean false The indicator of whether this objective needs a verification. -
alternatives [Objective] false The list of alternative objectives associated with the objective. -
conditions [Condition] false The conditions of the objective. -
sources [string] false The data sources that are allowed by the system. The following sources are possible:
- SPECIFIC_PROVIDER: Indicates that the data is from a service provider.
- CLAIM: Indicates that the data is from a claim.
- APP_DEVICE: Indicates that the data is from a device such as a Fitbit.
- COACH_ENTERED: Indicates that the data was entered by a health coach.
- ADMINISTRATOR_UPLOADED: Indicates that the data was entered by an administrator.
- EMR_DW_INTEGRATION: Indicates that the data is from an integrated EHR system.
SPECIFIC_PROVIDER, CLAIM, SELF_ENTERED, APP_DEVICE, COACH_ENTERED, ADMINISTRATOR_UPLOADED, EMR_DW_INTEGRATION
codings [Coding] false The list of code systems referenced by the objective. -
reward object false The incentive reward for the objective. -
createdAt string false The date and time when the objective was created, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
updatedAt string false The date and time when the objective was last updated, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -

Condition

Name Type Required Description Accepted Values
value integer(int32) true The value of the condition. -
operator string true The conditional operator of the objective. =, >, <, <=, >=, INCREASE_PERCENTAGE, DECREASE_PERCENTAGE, IMPROVE_PERCENTAGE, MATCHES
target integer(int32) true The target range of the objective. -
consumerConditionType string false The type of conditions related to the consumer. AGE, GENDER, DIABETIC
subtype string false The subtype against which the condition type is compared, for example, SYSTOLIC or DIASTOLIC. -

Coding

Name Type Required Description Accepted Values
referenceId string true The reference ID of the code system. -
kind string true The type of the code system. -

Objectives

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

patchCampaignDefinitionsCampaignidCategoryDefinitionsCategoryidObjectiveDefinitions

Name Type Required Description Accepted Values
titles [object] false A list of objective names for the different locales. -
» locale string true A two-letter language and two-letter region ID, for example, en-US. The locale should match the ISO 639-1 specification. See ISO 639 Language Codes on the ISO website for more information. -
» text string true The title of the objective for the specified locale. The maximum length is 191 characters. -
descriptions [object] false A list of objective descriptions for the different locales. -
» locale string true A two-letter language and two-letter region ID, for example, en-US. The locale should match the ISO 639-1 specification. See ISO 639 Language Codes on the ISO website for more information. -
» text string true The descriptions of the objective for the specified locale. The maximum length is 191 characters. -
sourceDefinition object false The source system in which the activity is defined. -
» id string false The ID of the source system. -
» kind string true The type of the source system in which the activity is defined, for example, EDUCATION_MODULE or QUESTIONNAIRE. -
frequency string false The frequency of the objective. DAILY, WEEKLY, MONTHLY, QUARTERLY, BI_ANNUALLY, ANNUALLY, ONE_TIME
isRepeatableWithinFrequency boolean false Indicates whether the objective can be completed multiple times within the objective frequency. -
requiresVerification boolean false Indicates whether the objective must be verified. When this is set to true, the objective must be verified and marked as complete by an administrator or care provider. -
startsAt string false The date and time when the objective starts, in ISO 8601 format. -
endsAt string false The date and time when the objective ends, in ISO 8601 format. -
maxCompletionCount integer(int32) false The maximum number of times the objective can be completed. This can be used only for completion-based objectives. -
sources [string] false The sources that are permitted to meet an objective. If this is not specified, all sources are permitted. The following sources are possible:
- SPECIFIC_PROVIDER: Indicates that the data is from a service provider.
- CLAIM: Indicates that the data is from a claim.
- APP_DEVICE: Indicates that the data is from a device such as a Fitbit.
- COACH_ENTERED: Indicates that the data was entered by a health coach.
- ADMINISTRATOR_UPLOADED: Indicates that the data was entered by an administrator.
- EMR_DW_INTEGRATION: Indicates that the data is from an integrated EHR system.
SPECIFIC_PROVIDER, CLAIM, SELF_ENTERED, APP_DEVICE, COACH_ENTERED, ADMINISTRATOR_UPLOADED, EMR_DW_INTEGRATION
conditions [object] false A list of conditions for the objective. -
» value string false The value for the condition. -
» operator string false The conditional operator of the objective. If the consumerConditionType is GENDER or DIABETIC, the MATCHES operator must be used. If the consumerConditionType is AGE, one of the following operators must be used: [‘>’, ‘<’, ‘<=’, ‘>=’]. =, >, <, <=, >=, INCREASE_PERCENTAGE, DECREASE_PERCENTAGE, IMPROVE_PERCENTAGE, MATCHES
» target string false The target range of the objective. -
» subtype string false The subtype against which the condition type is compared, for example, SYSTOLIC or DIASTOLIC. -
» consumerConditionType string false The type of conditions related to consumer. AGE, GENDER, DIABETIC
codings [object] false The list of code systems referenced by the objective. -
» referenceId string true A reference to the coding system. This is either system<code>&#124;</code>code when the kind value is ontology#code or contextId<code>&#124;</code>alias when the kind value is ontology#concept. -
» kind string true The type of the coding system. -
reward object false The incentive reward for the objective. -
» id string false The ID of the reward. -
» limitPerFrequency string false The maximum number of times this reward can be given per frequency. -

postCampaigns

Name Type Required Description Accepted Values
templateCampaignId string true The template campaign ID is the ID that is used to retrieve a published campaign. A campaign instance is retrieved using the specified template campaign ID, and the categories, objectives, and rewards are retrieved from the campaign instance to create a new set of those entities and associate them with the newly created campaign. Values for the startsAt and endsAt fields are required to create the new campaign. If a name, description, or gracePeriodEndsAt value is specified, those values are used for the new campaign. If name and description values are omitted, the template campaign’s values are used; however, if the gracePeriodEndsAt value is omitted, the value is null. -
names [string] false A list of campaign names for the different locales. -
descriptions [string] false A list of campaign descriptions for the different locales. -
gracePeriodEndsAt string(date-time) false The date and time until which a member can continue to submit completed data and activities and still earn incentives points after a campaign ends, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. Must be later than the campaign endsAt date. -
startsAt string(date-time) true The date and time when the campaign starts, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
endsAt string(date-time) true The date and time when the campaign ends, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -

Campaign

Name Type Required Description Accepted Values
campaignId string true The ID of the campaign. -

CampaignInstances

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

CampaignInstance

Name Type Required Description Accepted Values
id string true The ID of the campaign instance. -
campaignId string true The ID of the campaign. -
categoryId string true The ID of the category associated with the campaign. -
names [Translation] true The name of the campaign. -
descriptions [Translation] false The description of the campaign. -
completionThreshold integer(int32) false The completion threshold number for the campaign. -
startsAt string true The date and time when the campaign starts, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
endsAt string true The date and time when the campaign ends, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
gracePeriodEndsAt string true The date until which a consumer can receive rewards for objectives in their campaign, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
reward RewardDefinition false Retrieves a single wellness incentive reward definition by ID. -
adjustmentReward RewardDefinition false Retrieves a single wellness incentive reward definition by ID. -
timeZone string false The time zone in which the campaign is created. -
icon string false The file name of the icon. -
populations [Population] false The populations associated with the campaign instance. -
createdAt string false The date and time when the campaign was created, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
updatedAt string false The date and time when the campaign was last updated, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
categories [Category] true The list of categories for the campaign. -
objectives [ObjectiveDefinition] true The list of objectives for the campaign. -

RewardDefinition

Name Type Required Description Accepted Values
id string true The ID of the reward. -
value integer(int32) false The value of the reward that is awarded every time the reward is earned. -
limit integer(int32) true The maximum number of rewards that can be earned. -
units [UnitReference] true No description -

UnitReference

Name Type Required Description Accepted Values
singularName string false No description -
pluralName string false No description -
locale string false No description -

Category

Name Type Required Description Accepted Values
id string true The ID of the category. -
parentCategoryId string false The ID of the parent category of the category. -
names [Translation] true The name of the category. -
descriptions [Translation] false The description of the category. -
reward RewardDefinition false Retrieves a single wellness incentive reward definition by ID. -
adjustmentReward RewardDefinition false Retrieves a single wellness incentive reward definition by ID. -
completionThreshold integer(int32) false The completion threshold number for the category. -
icon string false The file name of the icon. -
startsAt string false The date and time when the category starts, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
endsAt string false The date and time when the category ends, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
createdAt string false The date and time when the category was created, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZformat. -
updatedAt string false The date and time when the category was last updated, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
objectives [ObjectiveDefinition] false The list of objectives associated with the category. -
categories [Category] false The child categories associated with the category. -

ObjectiveDefinition

Name Type Required Description Accepted Values
id string true The ID of the objective. -
activity_definition_id string true The ID of the activity definition. -
position integer(int32) true The number position of the objective. -
titles [Translation] true The name of the objective. -
descriptions [Translation] false The description of the objective. -
startsAt string true The date and time when the objective starts, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
endsAt string true The date and time when the objective ends, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
sourceDefinition object true The source systems in which the activity is defined. -
frequency string false How often the objective can be completed. DAILY, WEEKLY, MONTHLY, QUARTERLY, BI_ANNUALLY, ANNUALLY, ONE_TIME
isRepeatableWithinFrequency boolean false Indicates whether the objective can be completed multiple times within the objective frequency. -
maxCompletionCount integer(int32) false The maximum number of times the objective can be completed over the entire period of the campaign. -
primaryObjectiveId string false The ID of an existing valid objective. An objective with the primaryObjectiveId attribute is an alternative objective. -
acceptsAllSources boolean false Indicates whether all sources are acceptable. -
requiresVerification boolean false Indicates whether the objective must be verified before completion. -
alternatives [ObjectiveDefinition] false The list of alternative objectives associated with the objective. -
conditions [Condition] false The conditions of the objective -
codings [Coding] false The list of code systems referenced by the objective. -
sources string false The data sources that are allowed by the system. The following sources are possible:
- SPECIFIC_PROVIDER: Indicates that the data is from a service provider.
- CLAIM: Indicates that the data is from a claim.
- APP_DEVICE: Indicates that the data is from a device such as a Fitbit.
- COACH_ENTERED: Indicates that the data was entered by a health coach.
- ADMINISTRATOR_UPLOADED: Indicates that the data was entered by an administrator.
- EMR_DW_INTEGRATION: Indicates that the data is from an integrated EHR system.
SPECIFIC_PROVIDER, CLAIM, SELF_ENTERED, APP_DEVICE, COACH_ENTERED, ADMINISTRATOR_UPLOADED, EMR_DW_INTEGRATION
incentive Incentive false The incentive for completing the objective. -

Incentive

Name Type Required Description Accepted Values
id string true The ID of the incentive. -
objectiveId string true The ID of the objective. -
rewardLimitPerFrequency integer(int32) true The maximum number of times a consumer can earn points for completing the objective in a frequency. -
reward RewardDefinition false Retrieves a single wellness incentive reward definition by ID. -

postCampaignInstances

Name Type Required Description Accepted Values
campaignId string true The ID of the campaign. -

postCampaignMemberships

Name Type Required Description Accepted Values
campaignId string true The ID of an incentive campaign. -
consumerId string true The ID of a HealtheIntent consumer. See Consumer API for more information. -

CampaignMembership

Name Type Required Description Accepted Values
id string true The ID of the campaign membership. -
campaignId string true The ID of the incentive campaign. -
consumerId string true The ID of the consumer. -
createdAt string false The date and time when the campaign membership was created, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
updatedAt string false The date and time when the campaign membership was last updated, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -

CampaignMemberships

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

postRewardDefinitions

Name Type Required Description Accepted Values
value integer(int32) true The value of the reward earned. -
limit integer(int32) true The maximum number of rewards that can be earned. -
units [object] true A list of unit locales supported for the reward. -
» singularName string true The singular name for the currency unit for rewards. -
» pluralName string true The plural name for the currency unit for the rewards. -
» locale string true The locale for the currency unit. -

RewardDefinitions

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

patchRewardDefinitions

Name Type Required Description Accepted Values
value integer(int32) false The value of the reward earned. -
limit integer(int32) false The maximum number of rewards that can be earned. -
units [object] false A list of unit locales supported for the reward. -
» singularName string true The singular name for the currency unit for the rewards. -
» pluralName string true The plural name for the currency unit for the rewards. -
» locale string true The locale for the currency unit. -

ConsumerIncentiveRewardLists

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

ConsumerIncentiveRewardList

Name Type Required Description Accepted Values
id string true The ID of the reward. -
consumer ConsumerReference false The related resource of the consumer. -
reward RewardReference false The related resource of the reward. -
earned integer(int32) true The earned reward. This is the total number of points that the consumer earned, regardless of the limit for the reward. -
effective integer(int32) true The effective of the earned reward. This is the number of points that the consumer earns after the limit of the reward is applied. For example, if the consumer earns 11 points but the limit is 10, the consumer earns 10 points. -
createdAt string(date-time) false The date and time when the consumer reward was earned, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
updatedAt string(date-time) false The date and time when the consumer reward was updated, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -

ConsumerReference

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

RewardReference

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

ConsumerIncentiveReward

Name Type Required Description Accepted Values
id string true The ID of the reward. -
consumer ConsumerReference false The related resource of the consumer. -
reward RewardReference false The related resource of the reward. -
earned integer(int32) true The earned reward. This is the total number of points that the consumer earned, regardless of the limit for the reward. -
effective integer(int32) true The effective of the earned reward. This is the number of points that the consumer earns after the limit of the reward is applied. For example, if the consumer earns 11 points but the limit is 10, the consumer earns 10 points. -
createdAt string(date-time) false The date and time when the consumer reward was earned, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
updatedAt string(date-time) false The date and time when the consumer reward was updated, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
transactions [Transaction] false An array that contains every transaction of the consumer reward. -

Transaction

Name Type Required Description Accepted Values
id string true The ID of the reward. -
delta integer(int32) true The delta of the reward. This is the change in the reward total that the transaction causes and can be negative or positive. -
referenceSystem string true The reference system in which reward is identified. -
createdAt string(date-time) false The date and time when the consumer reward was earned, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
updatedAt string(date-time) false The date and time when the consumer reward was updated, in ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -

ObjectiveStatuses

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

ObjectiveStatus

Name Type Required Description Accepted Values
consumer string true The ID of the consumer. -
objectiveDefinition ObjectiveReference true A reference to the objective definition. -
overallStatus string true The overall status of the objective for the consumer. This applies only to completion-based objectives. IN_PROGRESS, COMPLETED
overallCompletionCount integer(int32) false The number of times an objective was completed by the consumer. -
detailsByFrequency [ObjectiveInstance] false A list of the instances of a consumer’s fulfillment of an objective. -

ObjectiveReference

Name Type Required Description Accepted Values
id string true The ID of the objective definition. -
sourceDefinition string true The source system in which the objective is defined. -

ObjectiveInstance

Name Type Required Description Accepted Values
status string true The status of the consumer objective. IN_PROGRESS, COMPLETED
frequencyBeginsAt string false The beginning date of the frequency for the objective. -
completionCount integer(int32) false The number of times the objective is achieved in the given frequency. This is the sum of the activityCount and adminAwardedCount values. -
activityCount integer(int32) false The number of times the consumer accomplishes the objective in the given frequency. -
adminAwardedCount integer(int32) false The number of exemptions awarded by an administrator for the goal in the given frequency. -
consumerActivitySourceDefinitions [object] false The definition IDs that correspond to the consumer activity sources for the consumer objective. -

postCampaignObjectives

Name Type Required Description Accepted Values
consumer object true The ID of the consumer. -
» id string true The ID of the consumer. -
locale string false A two-letter language and two-letter region ID. Only en-US is supported currently. -
activity object true The details of the consumer activity. -
» id string false The ID of the consumer activity. -
» sourceDefinition object true The source system in which the activity is defined. -
»» id string true The ID of the source system. -
»» kind string true The type of the source system in which the activity is defined, for example, [wellness#learningModules, wellness#HealthyHabit]. -
» performedOn string false The date on which the activity is performed. -
» name string false The name of the activity. -
» details string false The description of the activity. -
» providerName string false The name of the provider for the activity. -
» providerLocation string false The location of the provider for the activity. -
» status string false The verification status for the consumer activity. PENDING, APPROVED, DENIED

IncentiveCalculationList

Name Type Required Description Accepted Values
items [IncentiveCalculation] true No description -

IncentiveCalculation

Name Type Required Description Accepted Values
campaign string true The ID of the campaign. -
completionCount integer(int32) false The total number of times an objective was completed in the frequency. -
pointsAchieved integer(int32) false The number of incentive points that were achieved. -
unit UnitReference false No description -

postEligibilityRecords

Name Type Required Description Accepted Values
eligibilityRecords [object] true A list of eligibility records. -
» consumer object true A reference to the member documented in the eligibility record. -
»» id string true The ID of the consumer. -
» memberId string true The tenant-configurable ID that uniquely identifies an eligible member. This ID is used to verify the identity of an eligible member. -
» dateOfBirth string true The birth date of an eligible member in ISO 8601 yyyy-mm-dd format. The birth date is used to verify the identity of an eligible member. -
» familyName string true The surname of an eligible member. The surname is used to verify the identity of an eligible member. -
» givenName string false The first name of an eligible member. The first name is used to verify the identity of an eligible member. -
» middleName string false The middle name of an eligible member. The middle name is used to verify the identity of an eligible member. -
» gender string false The administrative gender code of am eligible member. The administrative gender can differ from a eligible member’s clinical sex, preferred gender identity, legal sex, and birth sex. MALE, FEMALE, UNKNOWN
» relationship string false The relationship of an eligible member to a client, for example, EMPLOYEE_SPOUSE is a spouse of an employee. PLAN_MEMBER, PLAN_MEMBER_SPOUSE, EMPLOYEE, EMPLOYEE_SPOUSE
» terminationDate string false The termination date of an eligible member. This date indicates when an eligible member is disabled from using the Consumer Well-being system. -
» addresses [object] false The addresses of an eligible member. -
»» use string true The purpose of the address, for example, HOME or WORK. -
»» text string false The fully-formatted address. -
»» lines [string] false An ordered list of address lines indicating the house number, apartment number, street name, street direction, P.O. Box number, and similar address information. -
»» city string false The name of the city, town, or village. -
»» state string false The state or other subunit of a country. -
»» postalCode string false The region defined by the postal service for this address. -
»» country string false The nation specified for this address. -
» telecoms [object] false The contact details for an eligible member. This information is used to verify the identity of an eligible member. -
»» system string true The system of the telecom. Currently, only EMAIL and PHONE are supported. EMAIL, PHONE
»» value string true The value of the telecom. -
» memberGroup string false The member group of an eligible member. This information is used to attach an alias to a consumer group in the Consumer Well-being system. -
» additionalInformation [object] false The additional information section is providing the ability to attach any metadata that is related but does not supply any semantic meaning to the eligibility record. - There may be a maximum of 10 name/value pairs used for describing metadata of an eligibility record. -
»» name string true A name of the field describing the metadata of the eligibility record. The maximum length is 191 characters. -
»» value string true The value of the metadata of the eligibility record. The maximum length is 191 characters. -
» updatedBy object false Information about the source from which the eligibility record has been created or modified, such as type and ID. -
»» type string true The type describes who or what created or updated the eligibility record. Currently, eligibility record information can be created or modified using the eligibility adapter or by an individual, such as an administrator. SYSTEM, ADMIN
»» id string true An ID for a system or person, such as an administrator, that creates or updates the eligibility record. -

EligibilityRecordList

Name Type Required Description Accepted Values
eligibilityRecords [EligibilityRecord] true A list of eligibility records. -

EligibilityRecord

Name Type Required Description Accepted Values
id string true The ID of the eligibility record. -
consumer ConsumerReference true A reference to the member documented in the eligibility record. -
memberId string true The tenant-configurable ID that uniquely identifies an eligible member. This ID is used to verify the identity of an eligible member. -
dateOfBirth string true The birth date of an eligible member in ISO 8601 yyyy-mm-dd format. The birth date is used to verify the identity of an eligible member. -
familyName string true The surname of an eligible member. The surname is used to verify the identity of an eligible member. -
givenName string false The first name of an eligible member. The first name is used to verify the identity of an eligible member. -
middleName string false The middle name of an eligible member. The middle name is used to verify the identity of an eligible member. -
gender string false The administrative gender code of am eligible member. The administrative gender can differ from a eligible member’s clinical sex, preferred gender identity, legal sex, and birth sex. MALE, FEMALE, UNKNOWN
relationship string false The relationship of an eligible member to a client, for example, EMPLOYEE_SPOUSE is a spouse of an employee. PLAN_MEMBER, PLAN_MEMBER_SPOUSE, EMPLOYEE, EMPLOYEE_SPOUSE
terminationDate string false The termination date of an eligible member. This date indicates when an eligible member is disabled from using the Consumer Well-being system. -
addresses [Address] false The addresses of an eligible member. -
telecoms [Telecom] false The contact details for an eligible member. This information is used to verify the identity of an eligible member. -
memberGroup string false The member group of an eligible member. This information is used to attach an alias to a consumer group in the Consumer Well-being system. -
additionalInformation [AdditionalInformation] false The additional information section is providing the ability to attach any metadata that is related but does not supply any semantic meaning to the eligibility record. - There may be a maximum of 10 name/value pairs used for describing metadata of an eligibility record. -
updatedBy UpdatedBy false Information about the source from which the eligibility record has been created or modified, such as type and ID. -

Address

Name Type Required Description Accepted Values
use string false The purpose of the address, for example, HOME or WORK. HOME, WORK
text string false The fully-formatted address. -
lines [string] false An ordered list of address lines indicating the house number, apartment number, street name, street direction, P.O. Box number, and similar address information. -
city string false The name of the city, town, or village. -
state string false The state or other subunit of a country. -
postalCode string false The region defined by the postal service for this address. -
country string false The nation specified for this address. -

Telecom

Name Type Required Description Accepted Values
system string true The system of the telecom. Currently, only EMAIL and PHONE are supported. EMAIL, PHONE
value string true The value of the telecom. -

AdditionalInformation

Name Type Required Description Accepted Values
name string true A name of the field describing the metadata of the eligibility record. The maximum length is 191 characters. -
value string true The value of the metadata of the eligibility record. The maximum length is 191 characters. -

UpdatedBy

Name Type Required Description Accepted Values
type string true The type describes who or what created or updated the eligibility record. Currently, eligibility record information can be created or modified using the eligibility adapter or by an individual, such as an administrator. SYSTEM, ADMIN
id string true An ID for a system or person, such as an administrator, that creates or updates the eligibility record. -

BadRequestError

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 [BadRequestErrorDetail] 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. -

BadRequestErrorDetail

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

UnauthorizedError

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 [UnauthorizedErrorDetail] false A list of additional error details. -

UnauthorizedErrorDetail

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

ForbiddenError

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 [ForbiddenErrorDetail] false A list of additional error details. -

ForbiddenErrorDetail

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

EligibilityRecords

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

putEligibilityRecords

Name Type Required Description Accepted Values
consumer object false A reference to the member documented in the eligibility record. -
» id string true The ID of the consumer. -
memberId string false The tenant-configurable ID that uniquely identifies an eligible member. This ID is used to verify the identity of an eligible member. -
dateOfBirth string false The birth date of an eligible member in ISO 8601 yyyy-mm-dd format. The birth date is used to verify the identity of an eligible member. -
familyName string false The surname of an eligible member. The surname is used to verify the identity of an eligible member. -
givenName string false The first name of an eligible member. The first name is used to verify the identity of an eligible member. -
middleName string false The middle name of an eligible member. The middle name is used to verify the identity of an eligible member. -
gender string false The administrative gender code of am eligible member. The administrative gender can differ from a eligible member’s clinical sex, preferred gender identity, legal sex, and birth sex. MALE, FEMALE, UNKNOWN
relationship string false The relationship of an eligible member to a client, for example, EMPLOYEE_SPOUSE is a spouse of an employee. PLAN_MEMBER, PLAN_MEMBER_SPOUSE, EMPLOYEE, EMPLOYEE_SPOUSE
terminationDate string false The termination date of an eligible member. This date indicates when an eligible member is disabled from using the Consumer Well-being system. -
addresses [object] false The addresses of an eligible member. -
» use string true The purpose of the address, for example, HOME or WORK. -
» text string false The fully-formatted address. -
» lines [string] false An ordered list of address lines indicating the house number, apartment number, street name, street direction, P.O. Box number, and similar address information. -
» city string false The name of the city, town, or village. -
» state string false The state or other subunit of a country. -
» postalCode string false The region defined by the postal service for this address. -
» country string false The nation specified for this address. -
telecoms [object] false The contact details for an eligible member. This information is used to verify the identity of an eligible member. -
» system string true The system of the telecom. Currently, only EMAIL and PHONE are supported. EMAIL, PHONE
» value string true The value of the telecom. -
memberGroup string false The member group of an eligible member. This information is used to attach an alias to a consumer group in the Consumer Well-being system. -
additionalInformation [object] false The additional information section is providing the ability to attach any metadata that is related but does not supply any semantic meaning to the eligibility record. - There may be a maximum of 10 name/value pairs used for describing metadata of an eligibility record. -
» name string true A name of the field describing the metadata of the eligibility record. The maximum length is 191 characters. -
» value string true The value of the metadata of the eligibility record. The maximum length is 191 characters. -
updatedBy object false Information about the source from which the eligibility record has been created or modified, such as type and ID. -
» type string true The type describes who or what created or updated the eligibility record. Currently, eligibility record information can be created or modified using the eligibility adapter or by an individual, such as an administrator. SYSTEM, ADMIN
» id string true An ID for a system or person, such as an administrator, that creates or updates the eligibility record. -

NotFoundError

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 [NotFoundErrorDetail] false A list of additional error details. -

NotFoundErrorDetail

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

PhaDefinitions

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

PhaDefinition

Name Type Required Description Accepted Values
id string true The ID of the PHA definition. -
phaId string true The ID of the PHA. -
name string true The name of the PHA. The value of this attribute is unique for every phaId value. -
locale string true The locale of the PHA. -
description string false The human-readable description of the PHA. -
code Code false The PHA code from a single, specified (not fixed) code system. -

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

postPhaDefinitions

Name Type Required Description Accepted Values
name string true The name of the PHA. The value of this attribute is unique for every phaId value. -
phaId string true The ID of the PHA. -
locale string true The locale of the PHA. -
description string false The human-readable description of the PHA. -
code object false A code represents a concept for the PHA definition from a single, specified code system. -
» code string true The unique ID of the code. -
» system string true The unique ID of the coding system that gives meaning to the code. -
» display string false A human-readable representation of the code. -

putPhaDefinitions

Name Type Required Description Accepted Values
name string true The name of the PHA. The value of this attribute is unique for every phaId value. -
phaId string true The ID of the PHA. -
locale string true The locale of the PHA. -
description string false The human-readable description of the PHA. -
code object false A code represents a concept for the PHA definition from a single, specified code system. -
» code string true The unique ID of the code. -
» system string true The unique ID of the coding system that gives meaning to the code. -
» display string false A human-readable representation of the code. -

PhaSections

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

PhaSection

Name Type Required Description Accepted Values
id string true The ID of the PHA section. -
name string true The name of the PHA section. -
description string false The human-readable description of the PHA section. -
position integer(int32) true A position of a section indicates that the section must be at the given position in the sequence of sections in the PHA. The position must be unique within the PHA. -
code Code false The code of the PHA section from a single, specified (not fixed) code system. -

postPhaDefinitionsPhadefinitionidSections

Name Type Required Description Accepted Values
name string true The name of the PHA section. -
description string false The human-readable description of the PHA section. -
position integer(int32) true A position of a section indicates that the section must be at the given position in the sequence of sections in the PHA. The position must be unique within the PHA. -
code object false A code represents a concept for the PHA section from a single, specified code system. -
» code string true The unique ID of the code. -
» system string true The unique ID of the coding system that gives meaning to the code. -
» display string false A human-readable representation of the code. -

putPhaDefinitionsPhadefinitionidSections

Name Type Required Description Accepted Values
name string true The name of the PHA section. -
description string false The human-readable description of the PHA section. -
position integer(int32) true A position of a section indicates that the section must be at the given position in the sequence of sections in the PHA. The position must be unique within the PHA. -
code object false A code represents a concept for the PHA section from a single, specified code system. -
» code string true The unique ID of the code. -
» system string true The unique ID of the coding system that gives meaning to the code. -
» display string false A human-readable representation of the code. -

PhaSubsections

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

PhaSubsection

Name Type Required Description Accepted Values
id string true The ID of the PHA subsection. -
name string true The name of the PHA subsection. -
description string false The human-readable description of the PHA subsection. -
position integer(int32) true A position of a section indicates that the subsection must be at the given position in the sequence of subsections in the PHA section. The position must be unique within the section in which the subsection is grouped. -
code Code false The code of the PHA subsection from a single, specified (not fixed) code system. -
section PhaSectionReference true A reference to the PHA section. -

PhaSectionReference

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

postPhaDefinitionsPhadefinitionidSubsections

Name Type Required Description Accepted Values
name string true The name of the PHA subsection. -
description string false The human-readable description of the PHA subsection. -
position integer(int32) true A position of a section indicates that the subsection must be at the given position in the sequence of subsections in the PHA section. The position must be unique within the section in which the subsection is grouped. -
code object false The code of the PHA subsection from a single, specified (not fixed) code system. -
» code string true The unique ID of the code. -
» system string true The unique ID of the coding system that gives meaning to the code. -
» display string false A human-readable representation of the code. -
section object true A reference to the PHA section. -
» id string true The ID of the PHA section. -

putPhaDefinitionsPhadefinitionidSubsections

Name Type Required Description Accepted Values
name string true The name of the PHA subsection. -
description string false The human-readable description of the PHA subsection. -
position integer(int32) true A position of a section indicates that the subsection must be at the given position in the sequence of subsections in the PHA section. The position must be unique within the section in which the subsection is grouped. -
code object false The code of the PHA subsection from a single, specified (not fixed) code system. -
» code string true The unique ID of the code. -
» system string true The unique ID of the coding system that gives meaning to the code. -
» display string false A human-readable representation of the code. -
section object true A reference to the PHA section. -
» id string true The ID of the PHA section. -

PhaQuestions

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

PhaQuestion

Name Type Required Description Accepted Values
id string true The ID of the PHA question. -
text string true The human-readable text of the question. -
type string true The type of the question in the PHA. The following types are available:
- TEXT A question with a long, potentially multiparagraph free-text answer.
- STRING A question with a short free-text answer. The maximum length is 255 characters.
- DATE_TIME A question with a date and time answer.
- CHOICE A question with a choice from a list of options as an answer.
- DATE A question with a date answer.
- OPEN_CHOICE A question with a choice from a list of options (as with the CHOICE type) or a free-text answer.
- RANGE A question with an answer that is a numeric value between a high and a low value.
TEXT, STRING, DATE_TIME, CHOICE, RANGE, DATE, OPEN_CHOICE
description string false A free-text description of the PHA question that provides instructions or additional context for a user to answer the question. -
acceptsMultipleAnswers boolean true Indicates whether the question can have more than one answer. -
required boolean true Indicates whether the question must be answered in a completed response. -
position integer(int32) true Indicates that the question must be at the given position in the sequence of questions in the section or subsection. The position must be unique within the section or the subsection in which the question is grouped. -
section PhaSectionReference false A reference to the PHA section. A question should be in either a section or a subsection. -
subsection PhaSubsectionReference false A reference to the PHA subsection. A question should be in either a section or a subsection. -
code Code false The code for the PHA question from a single, specified (not fixed) code system. -
options [Option] false The possible answers to the PHA question. -

PhaSubsectionReference

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

Option

Name Type Required Description Accepted Values
id string true The ID of the PHA option. -
choice Choice false A permitted choice that can be chosen as an answer to the question. -
range Range false The permitted range in which the answer can be chosen for the question. -

Choice

Name Type Required Description Accepted Values
points integer(int32) false The total points earned by selecting this choice as an answer to the question. -
text string true A free-text description of the choice. -

Range

Name Type Required Description Accepted Values
low number(float) true The lowest possible value for the answer. The boundary is inclusive. -
high number(float) true The highest possible value for the answer. The boundary is inclusive. -
text string true A human-readable description of the range. -

postPhaDefinitionsPhadefinitionidQuestions

Name Type Required Description Accepted Values
text string true The human-readable text of the question. -
type string true The type of the question in the PHA. The following types are available:
- TEXT A question with a long, potentially multiparagraph free-text answer.
- STRING A question with a short free-text answer. The maximum length is 255 characters.
- DATE_TIME A question with a date and time answer.
- CHOICE A question with a choice from a list of options as an answer.
- DATE A question with a date answer.
- OPEN_CHOICE A question with a choice from a list of options (as with the CHOICE type) or a free-text answer.
- RANGE A question with an answer that is a numeric value between a high and a low value.
TEXT, STRING, DATE_TIME, CHOICE, RANGE, DATE, OPEN_CHOICE
description string false A free-text description of the PHA question that provides instructions or additional context for a user to answer the question. -
acceptsMultipleAnswers boolean false Indicates whether the question can have more than one answer. -
required boolean false Indicates whether the question must be answered in a completed response. -
position integer(int32) true Indicates that the question must be at the given position in the sequence of questions in the section or subsection. The position must be unique within the section or the subsection in which the question is grouped. -
section object false A reference to the PHA section. A question should be in either a section or a subsection. -
» id string true The ID of the PHA section. -
subsection object false A reference to the PHA subsection. A question should be in either a section or a subsection. -
» id string true The ID of the PHA subsection. -
code object false The code for the PHA question from a single, specified (not fixed) code system. -
» code string true The unique ID of the code. -
» system string true The unique ID of the coding system that gives meaning to the code. -
» display string false A human-readable representation of the code. -
options [object] false The possible answers to the PHA question. -
» choice object false A permitted choice that can be chosen as an answer to the question. -
»» points integer(int32) false The total points earned by selecting this choice as an answer to the question. -
»» text string true A free-text description of the choice. -
» range object false The permitted range in which the answer can be chosen for the question. -
»» low number(float) true The lowest possible value for the answer. The boundary is inclusive. -
»» high number(float) true The highest possible value for the answer. The boundary is inclusive. -
»» text string true A human-readable description of the range. -

putPhaDefinitionsPhadefinitionidQuestions

Name Type Required Description Accepted Values
text string true The human-readable text of the question. -
type string true The type of the question in the PHA. The following types are available:
- TEXT A question with a long, potentially multiparagraph free-text answer.
- STRING A question with a short free-text answer. The maximum length is 255 characters.
- DATE_TIME A question with a date and time answer.
- CHOICE A question with a choice from a list of options as an answer.
- DATE A question with a date answer.
- OPEN_CHOICE A question with a choice from a list of options (as with the CHOICE type) or a free-text answer.
- RANGE A question with an answer that is a numeric value between a high and a low value.
TEXT, STRING, DATE_TIME, CHOICE, RANGE, DATE, OPEN_CHOICE
description string false A free-text description of the PHA question that provides instructions or additional context for a user to answer the question. -
acceptsMultipleAnswers boolean false Indicates whether the question can have more than one answer. -
required boolean false Indicates whether the question must be answered in a completed response. -
position integer(int32) true Indicates that the question must be at the given position in the sequence of questions in the section or subsection. The position must be unique within the section or the subsection in which the question is grouped. -
section object false A reference to the PHA section. A question should be in either a section or a subsection. -
» id string true The ID of the PHA section. -
subsection object false A reference to the PHA subsection. A question should be in either a section or a subsection. -
» id string true The ID of the PHA subsection. -
code object false The code for the PHA question from a single, specified (not fixed) code system. -
» code string true The unique ID of the code. -
» system string true The unique ID of the coding system that gives meaning to the code. -
» display string false A human-readable representation of the code. -
options [object] false The possible answers to the PHA question. -
» choice object false A permitted choice that can be chosen as an answer to the question. -
»» points integer(int32) false The total points earned by selecting this choice as an answer to the question. -
»» text string true A free-text description of the choice. -
» range object false The permitted range in which the answer can be chosen for the question. -
»» low number(float) true The lowest possible value for the answer. The boundary is inclusive. -
»» high number(float) true The highest possible value for the answer. The boundary is inclusive. -
»» text string true A human-readable description of the range. -

PhaRules

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

PhaRule

Name Type Required Description Accepted Values
id string true The ID of the PHA rule. -
relation string false The relationship among multiple conditions for the rule. The relation can be either AND or OR. A combination of both is not supported. AND indicates that all conditions associated with this rule must be satisfied before the action can be taken. OR indicates that only one of the conditions associated with this rule must be satisfied before the action can be performed. AND, OR
conditions [PhaCondition] true Conditions define the list of constraints that must be satisfied by the answers in the PHA response before the action associated with the rule can be performed. -
action Action true The action to perform when the conditions are met for the rule. -

PhaCondition

Name Type Required Description Accepted Values
question PhaQuestionReference true A reference to the PHA question whose answers are used to satisfy the condition. -
type string true The type of relationship among the condition constraints. ALL_OF indicates that all constraints associated with the condition must be satisfied. ONE_OF indicates that only one of the constraints associated with the condition must be satisfied. ONE_OF, ALL_OF
values [Value] true The values to be compared with the answer of the question to determine if the condition is satisfied. -

PhaQuestionReference

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

Value

Name Type Required Description Accepted Values
option PhaOptionReference true A reference to the option. -
operator string false The comparison predicate with which to compare the answer in the referenced question. The following values are possible:
GT The answer is greater than the comparison value.
LT The answer is less than the comparison value.
GE The answer is greater than or equal to the comparison value.
LE The answer is less than or equal to the comparison value.
EQ The answer is equal to the comparison value.
NE The answer is not equal to the comparison value.
GT, LT, GE, LE, EQ, NE
value number(float) false The value against which to compare the answer. -

PhaOptionReference

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

Action

Name Type Required Description Accepted Values
questions [PhaQuestionReference] true A reference to the PHA questions for which the action is performed. Currently, the only action that can be performed is to display the PHA questions. -

postPhaDefinitionsPhadefinitionidRules

Name Type Required Description Accepted Values
relation string true The relationship among multiple conditions for the rule. The relation can be either AND or OR. A combination of both is not supported. AND indicates that all conditions associated with this rule must be satisfied before the action can be taken. OR indicates that only one of the conditions associated with this rule must be satisfied before the action can be performed. AND, OR
conditions [object] true Conditions define the list of constraints that must be satisfied by the answers in the PHA response before the action associated with the rule can be performed. -
» question object true A reference to the PHA question whose answers are used to satisfy the condition. -
»» id string true The ID of the PHA question. -
» values [object] true The values to be compared with the answer of the question to determine if the condition is satisfied. -
»» option object true A reference to the option. -
»»» id string true The ID of the PHA option. -
»» operator string false The comparison predicate with which to compare the answer in the referenced question. The following values are possible:
GT The answer is greater than the comparison value.
LT The answer is less than the comparison value.
GE The answer is greater than or equal to the comparison value.
LE The answer is less than or equal to the comparison value.
EQ The answer is equal to the comparison value.
NE The answer is not equal to the comparison value.
GT, LT, GE, LE, EQ, NE
»» value string false The value against which to compare the answer. -
» type string true The type of relationship among the condition constraints. ALL_OF indicates that all constraints associated with the condition must be satisfied. ONE_OF indicates that only one of the constraints associated with the condition must be satisfied. ONE_OF, ALL_OF
action object true The action to perform when the conditions are met for the rule. -
» questions [object] true A reference to the PHA questions for which the action is performed. Currently, the only action that can be performed is to display the PHA questions. -
»» id string true The ID of the PHA question. -

putPhaDefinitionsPhadefinitionidRules

Name Type Required Description Accepted Values
relation string true The relationship among multiple conditions for the rule. The relation can be either AND or OR. A combination of both is not supported. AND indicates that all conditions associated with this rule must be satisfied before the action can be taken. OR indicates that only one of the conditions associated with this rule must be satisfied before the action can be performed. AND, OR
conditions [object] true Conditions define the list of constraints that must be satisfied by the answers in the PHA response before the action associated with the rule can be performed. -
» question object true A reference to the PHA question whose answers are used to satisfy the condition. -
»» id string true The ID of the PHA question. -
» values [object] true The values to be compared with the answer of the question to determine if the condition is satisfied. -
»» option object true A reference to the option. -
»»» id string true The ID of the PHA option. -
»» operator string false The comparison predicate with which to compare the answer in the referenced question. The following values are possible:
GT The answer is greater than the comparison value.
LT The answer is less than the comparison value.
GE The answer is greater than or equal to the comparison value.
LE The answer is less than or equal to the comparison value.
EQ The answer is equal to the comparison value.
NE The answer is not equal to the comparison value.
GT, LT, GE, LE, EQ, NE
»» value string false The value against which to compare the answer. -
» type string true The type of relationship among the condition constraints. ALL_OF indicates that all constraints associated with the condition must be satisfied. ONE_OF indicates that only one of the constraints associated with the condition must be satisfied. ONE_OF, ALL_OF
action object true The action to perform when the conditions are met for the rule. -
» questions [object] true A reference to the PHA questions for which the action is performed. Currently, the only action that can be performed is to display the PHA questions. -
»» id string true The ID of the PHA question. -

postPublishedPersonalHealthAssessments

Name Type Required Description Accepted Values
phaDefinition object true A reference to the PHA definition that is used to create a published PHA. -
» id string true The ID of the PHA definition. -

PublishedPersonalHealthAssessment

Name Type Required Description Accepted Values
id string true The ID of the published PHA. -
phaDefinition Definition false A reference to the PHA definition that is used to create a published PHA. -

Definition

Name Type Required Description Accepted Values
id string true The ID of the PHA definition. -
phaId string true The ID of the PHA. -
name string true The name of the PHA. The value of this attribute is unique for every phaId value. -
locale string true The locale of the PHA. -
description string false The human-readable description of the PHA. -
code Code false The PHA code from a single, specified (not fixed) code system. -
sections [Section] false Sections are structured groups of subsections and questions for a PHA. -

Section

Name Type Required Description Accepted Values
id string true The ID of the PHA section. -
name string true The name of the PHA section. -
description string false The human-readable description of the PHA section. -
position integer(int32) true A position of a section indicates that the section must be at the given position in the sequence of sections in the PHA. The position must be unique within the PHA. -
code Code false The code of the PHA section from a single, specified (not fixed) code system. -
questions [Question] false Questions define the information necessary to guide the collection of answers from a HealtheIntent consumer about their health and wellness habits. -
subsections [Subsection] false Subsections are structured subgroups in PHA sections that contain the questions for a PHA. -

Question

Name Type Required Description Accepted Values
id string true The ID of the PHA question. -
text string true The human-readable text of the question. -
type string true The type of the question in the PHA. The following types are available:
- TEXT A question with a long, potentially multiparagraph free-text answer.
- STRING A question with a short free-text answer. The maximum length is 255 characters.
- DATE_TIME A question with a date and time answer.
- CHOICE A question with a choice from a list of options as an answer.
- DATE A question with a date answer.
- OPEN_CHOICE A question with a choice from a list of options (as with the CHOICE type) or a free-text answer.
- RANGE A question with an answer that is a numeric value between a high and a low value.
TEXT, STRING, DATE_TIME, CHOICE, RANGE, DATE, OPEN_CHOICE
description string false A free-text description of the PHA question that provides instructions or additional context for a user to answer the question. -
acceptsMultipleAnswers boolean true Indicates whether the question can have more than one answer. -
required boolean true Indicates whether the question must be answered in a completed response. -
position integer(int32) true Indicates that the question must be at the given position in the sequence of questions in the section or subsection. The position must be unique within the section or the subsection in which the question is grouped. -
section PhaSectionReference false A reference to the PHA section. A question should be in either a section or a subsection. -
subsection PhaSubsectionReference false A reference to the PHA subsection. A question should be in either a section or a subsection. -
code Code false The code for the PHA question from a single, specified (not fixed) code system. -
options [Option] false The possible answers to the PHA question. -
rule Rule false A rule defines the logic that is used to customize and control the behavior of the survey, for example, displaying or not displaying sections or questions based on the respondent’s answers, -

Rule

Name Type Required Description Accepted Values
id string true The ID of the PHA rule. -
relation string false The relationship among multiple conditions for the rule. The relation can be either AND or OR. A combination of both is not supported. AND indicates that all conditions associated with this rule must be satisfied before the action can be taken. OR indicates that only one of the conditions associated with this rule must be satisfied before the action can be performed. AND, OR
conditions [PhaCondition] true Conditions define the list of constraints that must be satisfied by the answers in the PHA response before the action associated with the rule can be performed. -

Subsection

Name Type Required Description Accepted Values
id string true The ID of the PHA subsection. -
name string true The name of the PHA subsection. -
description string false The human-readable description of the PHA subsection. -
position integer(int32) true A position of a section indicates that the subsection must be at the given position in the sequence of subsections in the PHA section. The position must be unique within the section in which the subsection is grouped. -
code Code false The code of the PHA subsection from a single, specified (not fixed) code system. -
section PhaSectionReference true A reference to the PHA section. -
questions [Question] false Questions define the information necessary to guide the collection of answers from a HealtheIntent consumer about their health and wellness habits. -

PhaRiskTypes

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

PhaRiskType

Name Type Required Description Accepted Values
id string true The ID of the risk type. -
name string true The name of the risk type. The value of this attribute is unique for every risk type. -
text string true The human-readable text of the risk type. -
code Code true The Risk Type code from a single, specified (not fixed) code system. -

postPhaRiskTypes

Name Type Required Description Accepted Values
name string true The name of the risk type. The value of this attribute is unique for every risk type. -
text string true The human-readable text of the risk type. -
code object true The Risk Type code from a single, specified (not fixed) code system. -
» code string true The unique ID of the code. -
» system string true The unique ID of the coding system that gives meaning to the code. -
» display string false A human-readable representation of the code. -

putPhaRiskTypes

Name Type Required Description Accepted Values
name string true The name of the risk type. The value of this attribute is unique for every risk type. -
text string true The human-readable text of the risk type. -
code object true The Risk Type code from a single, specified (not fixed) code system. -
» code string true The unique ID of the code. -
» system string true The unique ID of the coding system that gives meaning to the code. -
» display string false A human-readable representation of the code. -

PhaRiskInterpretations

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

PhaRiskInterpretation

Name Type Required Description Accepted Values
id string true The ID of the risk interpretation. -
text string true The human-readable text of the risk interpretation. -
name string true The name of the risk interpretation. The value of this attribute is unique for every risk interpretation. -
code Code true The Risk Interpretation code from a single, specified (not fixed) code system. -

postPhaRiskInterpretations

Name Type Required Description Accepted Values
text string true The human-readable text of the risk interpretation. -
name string true The name of the risk interpretation. The value of this attribute is unique for every risk interpretation. -
code object true The Risk Interpretation code from a single, specified (not fixed) code system. -
» code string true The unique ID of the code. -
» system string true The unique ID of the coding system that gives meaning to the code. -
» display string false A human-readable representation of the code. -

putPhaRiskInterpretations

Name Type Required Description Accepted Values
text string true The human-readable text of the risk interpretation. -
name string true The name of the risk interpretation. The value of this attribute is unique for every risk interpretation. -
code object true The Risk Interpretation code from a single, specified (not fixed) code system. -
» code string true The unique ID of the code. -
» system string true The unique ID of the coding system that gives meaning to the code. -
» display string false A human-readable representation of the code. -

PhaResponseDefinitions

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

PhaResponseDefinition

Name Type Required Description Accepted Values
id string true The ID of the PHA response definition. -
authoredAt string true The date and time when the PHA response was submitted or updated. The date and time must be in ISO 8601 YYYY-MM-DDThh:mm:ssTZD format, for example, 1997-07-16T19:20:30+01:00. -
publishedPhaDefinition PhaDefinitionReference true A reference to the PHA definition. -
consumer ConsumerReference true A reference to the HealtheIntent consumer. -
completedPhaResponses [CompletedPhaResponseReference] false A reference to the completed PHA response. -

PhaDefinitionReference

Name Type Required Description Accepted Values
id string true The ID of the PHA definition. -
name string true The name of the PHA. The value of this attribute is unique for every phaId value. -

CompletedPhaResponseReference

Name Type Required Description Accepted Values
id string true The ID of the completed PHA response. -
authoredAt string true The date and time when the PHA response was completed. The date and time must be in ISO 8601 YYYY-MM-DDThh:mm:ssTZD format, for example, 1997-07-16T19:20:30+01:00. -

postPhaResponseDefinitions

Name Type Required Description Accepted Values
authoredAt string true The date and time when the PHA response was submitted or updated. The date and time must be in ISO 8601 YYYY-MM-DDThh:mm:ssTZD format, for example, 1997-07-16T19:20:30+01:00. -
consumer object true A reference to the HealtheIntent consumer. -
» id string true The ID of the HealtheIntent consumer. -
phaDefinition object true A reference to the PHA definition. -
» id string true The ID of the PHA definition. -

putPhaResponseDefinitions

Name Type Required Description Accepted Values
authoredAt string true The date and time when the PHA response was submitted or updated. The date and time must be in ISO 8601 YYYY-MM-DDThh:mm:ssTZD format, for example, 1997-07-16T19:20:30+01:00. -
consumer object true A reference to the HealtheIntent consumer. -
» id string true The ID of the HealtheIntent consumer. -
phaDefinition object true A reference to the PHA definition. -
» id string true The ID of the PHA definition. -

PhaResponseSections

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

PhaResponseSection

Name Type Required Description Accepted Values
id string true The ID of the PHA response section. -
section PhaSectionReference true A reference to the PHA section. -
status string true The current state of the PHA response section. Currently, the following statuses are supported:
- NOT_STARTED Indicates that the HealtheIntent consumer has not started answering the PHA section.
- IN_PROGRESS Indicates that the HealtheIntent consumer is currently answering the PHA Section.
- COMPLETED Indicates that the HealtheIntent consumer has finished answering the PHA section.
NOT_STARTED, IN_PROGRESS, COMPLETED, ENTERED_IN_ERROR
answers [PhaAnswer] false The answers given by the HealtheIntent consumer to questions in the PHA section. -

PhaAnswer

Name Type Required Description Accepted Values
id string true The ID of the PHA answer. -
question PhaQuestionReference true A reference to the PHA question that is answered. -
values [AnswerValue] true The values of the answer. -

AnswerValue

Name Type Required Description Accepted Values
option OptionReference false A reference to the option that is chosen as the answer. -
value string false A value that represents the answer to the question. The following values are accepted for different types of questions:
- TEXT A long, potentially multiparagraph free-text answer. The maximum length is 65,535 characters.
- STRING A short free-text answer. The maximum length is 255 characters.
- DATE_TIME A date and time answer in ISO 8601 YYYY-MM-DDThh:mm:ssTZD format.
- CHOICE No answer value can be specified for this type of question.
- DATE A date answer in ISO 8601 YYYY-MM-DD format.
- OPEN_CHOICE A long, potentially multiparagraph free-text answer that is paired with options. The maximum length is 65,535 characters.
- RANGE A number between a high and a low value specified by the question with a precision that does not exceed 10 and a scale that does not exceed 3.
-

OptionReference

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

postPhaResponseDefinitionsPharesponsedefinitionidResponseSections

Name Type Required Description Accepted Values
status string false The current state of the PHA response section. Currently, the following statuses are supported:
- NOT_STARTED Indicates that the HealtheIntent consumer has not started answering the PHA section.
- IN_PROGRESS Indicates that the HealtheIntent consumer is currently answering the PHA Section.
- COMPLETED Indicates that the HealtheIntent consumer has finished answering the PHA section.
NOT_STARTED, IN_PROGRESS, COMPLETED, ENTERED_IN_ERROR
section object true A reference to the PHA section. -
» id string true The ID of the PHA section. -
answers [object] false The answers given by the HealtheIntent consumer to questions in the PHA section. -
» question object true A reference to the PHA question that is answered. -
»» id string true The ID of the PHA question. -
» values [object] true The values of the answer. -
»» option object false A reference to the option that is chosen as the answer. -
»»» id string true The ID of the PHA option. -
»» value string false A value that represents the answer to the question. The following values are accepted for different types of questions:
- TEXT A long, potentially multiparagraph free-text answer. The maximum length is 65,535 characters.
- STRING A short free-text answer. The maximum length is 255 characters.
- DATE_TIME A date and time answer in ISO 8601 YYYY-MM-DDThh:mm:ssTZD format.
- CHOICE No answer value can be specified for this type of question.
- DATE A date answer in ISO 8601 YYYY-MM-DD format.
- OPEN_CHOICE A long, potentially multiparagraph free-text answer that is paired with options. The maximum length is 65,535 characters.
- RANGE A number between a high and a low value specified by the question with a precision that does not exceed 10 and a scale that does not exceed 3.
-

putPhaResponseDefinitionsPharesponsedefinitionidResponseSections

Name Type Required Description Accepted Values
status string false The current state of the PHA response section. Currently, the following statuses are supported:
- NOT_STARTED Indicates that the HealtheIntent consumer has not started answering the PHA section.
- IN_PROGRESS Indicates that the HealtheIntent consumer is currently answering the PHA Section.
- COMPLETED Indicates that the HealtheIntent consumer has finished answering the PHA section.
NOT_STARTED, IN_PROGRESS, COMPLETED, ENTERED_IN_ERROR
section object true A reference to the PHA section. -
» id string true The ID of the PHA section. -
answers [object] false The answers given by the HealtheIntent consumer to questions in the PHA section. -
» question object true A reference to the PHA question that is answered. -
»» id string true The ID of the PHA question. -
» values [object] true The values of the answer. -
»» option object false A reference to the option that is chosen as the answer. -
»»» id string true The ID of the PHA option. -
»» value string false A value that represents the answer to the question. The following values are accepted for different types of questions:
- TEXT A long, potentially multiparagraph free-text answer. The maximum length is 65,535 characters.
- STRING A short free-text answer. The maximum length is 255 characters.
- DATE_TIME A date and time answer in ISO 8601 YYYY-MM-DDThh:mm:ssTZD format.
- CHOICE No answer value can be specified for this type of question.
- DATE A date answer in ISO 8601 YYYY-MM-DD format.
- OPEN_CHOICE A long, potentially multiparagraph free-text answer that is paired with options. The maximum length is 65,535 characters.
- RANGE A number between a high and a low value specified by the question with a precision that does not exceed 10 and a scale that does not exceed 3.
-

PhaResponseSubsections

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

PhaResponseSubsection

Name Type Required Description Accepted Values
id string true The ID of the PHA response subsection. -
status string true The current state of the PHA response subsection. Currently, the following statuses are supported:
- NOT_STARTED Indicates that the HealtheIntent consumer has not started answering the PHA subsection.
- IN_PROGRESS Indicates that the HealtheIntent consumer is currently answering the PHA subsection.
- COMPLETED Indicates that the HealtheIntent consumer has finished answering the PHA subsection.
NOT_STARTED, IN_PROGRESS, COMPLETED, ENTERED_IN_ERROR
subsection PhaSubsectionReference true A reference to the PHA subsection. -
answers [PhaAnswer] false The answers given by the HealtheIntent consumer to questions in the PHA subsection. -

postPhaResponseDefinitionsPharesponsedefinitionidResponseSubsections

Name Type Required Description Accepted Values
subsection object true A reference to the PHA subsection. -
» id string true The ID of the PHA subsection. -
status string false The current state of the PHA response subsection. Currently, the following statuses are supported:
- NOT_STARTED Indicates that the HealtheIntent consumer has not started answering the PHA subsection.
- IN_PROGRESS Indicates that the HealtheIntent consumer is currently answering the PHA subsection.
- COMPLETED Indicates that the HealtheIntent consumer has finished answering the PHA subsection.
NOT_STARTED, IN_PROGRESS, COMPLETED, ENTERED_IN_ERROR
answers [object] false The answers given by the HealtheIntent consumer to questions in the PHA subsection. -
» question object true A reference to the PHA question that is answered. -
»» id string true The ID of the PHA question. -
» values [object] true The values of the answer. -
»» option object false A reference to the option that is chosen as the answer. -
»»» id string true The ID of the PHA option. -
»» value string false A value that represents the answer to the question. The following values are accepted for different types of questions:
- TEXT A long, potentially multiparagraph free-text answer. The maximum length is 65,535 characters.
- STRING A short free-text answer. The maximum length is 255 characters.
- DATE_TIME A date and time answer in ISO 8601 YYYY-MM-DDThh:mm:ssTZD format.
- CHOICE No answer value can be specified for this type of question.
- DATE A date answer in ISO 8601 YYYY-MM-DD format.
- OPEN_CHOICE A long, potentially multiparagraph free-text answer that is paired with options. The maximum length is 65,535 characters.
- RANGE A number between a high and a low value specified by the question with a precision that does not exceed 10 and a scale that does not exceed 3.
-

putPhaResponseDefinitionsPharesponsedefinitionidResponseSubsections

Name Type Required Description Accepted Values
subsection object true A reference to the PHA subsection. -
» id string true The ID of the PHA subsection. -
status string false The current state of the PHA response subsection. Currently, the following statuses are supported:
- NOT_STARTED Indicates that the HealtheIntent consumer has not started answering the PHA subsection.
- IN_PROGRESS Indicates that the HealtheIntent consumer is currently answering the PHA subsection.
- COMPLETED Indicates that the HealtheIntent consumer has finished answering the PHA subsection.
NOT_STARTED, IN_PROGRESS, COMPLETED, ENTERED_IN_ERROR
answers [object] false The answers given by the HealtheIntent consumer to questions in the PHA subsection. -
» question object true A reference to the PHA question that is answered. -
»» id string true The ID of the PHA question. -
» values [object] true The values of the answer. -
»» option object false A reference to the option that is chosen as the answer. -
»»» id string true The ID of the PHA option. -
»» value string false A value that represents the answer to the question. The following values are accepted for different types of questions:
- TEXT A long, potentially multiparagraph free-text answer. The maximum length is 65,535 characters.
- STRING A short free-text answer. The maximum length is 255 characters.
- DATE_TIME A date and time answer in ISO 8601 YYYY-MM-DDThh:mm:ssTZD format.
- CHOICE No answer value can be specified for this type of question.
- DATE A date answer in ISO 8601 YYYY-MM-DD format.
- OPEN_CHOICE A long, potentially multiparagraph free-text answer that is paired with options. The maximum length is 65,535 characters.
- RANGE A number between a high and a low value specified by the question with a precision that does not exceed 10 and a scale that does not exceed 3.
-

postCompletedPhaResponses

Name Type Required Description Accepted Values
phaResponse object true A reference to the completed PHA response. -
» id string true The ID of the PHA response definition. -

CompletedPhaResponse

Name Type Required Description Accepted Values
id string true The ID of the completed PHA response. -
phaResponse Response true A reference to the completed PHA response. -

Response

Name Type Required Description Accepted Values
id string true The ID of the PHA response definition. -
authoredAt string true The date and time when the PHA response was submitted or updated. The date and time must be in ISO 8601 YYYY-MM-DDThh:mm:ssTZD format, for example, 1997-07-16T19:20:30+01:00. -
publishedPhaDefinition PhaDefinitionReference true A reference to the PHA definition. -
consumer ConsumerReference true A reference to the HealtheIntent consumer. -
responseSections [ResponseSection] false Sections are structured groups in PHA responses that contain answers for a PHA. -
responseSubsections [ResponseSubsection] false Subsections are structured subgroups in PHA response sections that contain the answers for a PHA. -

ResponseSection

Name Type Required Description Accepted Values
id string true The ID of the PHA response section. -
section PhaSectionReference true A reference to the PHA section. -
status string true The current state of the PHA response section. Currently, the following statuses are supported:
- NOT_STARTED Indicates that the HealtheIntent consumer has not started answering the PHA section.
- IN_PROGRESS Indicates that the HealtheIntent consumer is currently answering the PHA Section.
- COMPLETED Indicates that the HealtheIntent consumer has finished answering the PHA section.
NOT_STARTED, IN_PROGRESS, COMPLETED, ENTERED_IN_ERROR
answers [PhaAnswer] false The answers given by the HealtheIntent consumer to questions in the PHA section. -

ResponseSubsection

Name Type Required Description Accepted Values
id string true The ID of the PHA response subsection. -
status string true The current state of the PHA response subsection. Currently, the following statuses are supported:
- NOT_STARTED Indicates that the HealtheIntent consumer has not started answering the PHA subsection.
- IN_PROGRESS Indicates that the HealtheIntent consumer is currently answering the PHA subsection.
- COMPLETED Indicates that the HealtheIntent consumer has finished answering the PHA subsection.
NOT_STARTED, IN_PROGRESS, COMPLETED, ENTERED_IN_ERROR
subsection PhaSubsectionReference true A reference to the PHA subsection. -
answers [PhaAnswer] false The answers given by the HealtheIntent consumer to questions in the PHA subsection. -

CompletionCriterions

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

CompletionCriterion

Name Type Required Description Accepted Values
id string true The ID of the completion criterion. -
code ScreeningCode true The code of the screening configuration from a single, specified code system. -

ScreeningCode

Name Type Required Description Accepted Values
code string true The unique ID of the code. -
system string true The ID of the coding system that gives meaning to the code. -

postScreeningResultsCompletionCriteria

Name Type Required Description Accepted Values
code object true The code of the screening configuration from a single, specified code system. -
» code string true The unique ID of the code. -
» system string true The ID of the coding system that gives meaning to the code. -

putScreeningResultsCompletionCriteria

Name Type Required Description Accepted Values
code object true The code of the screening configuration from a single, specified code system. -
» code string true The unique ID of the code. -
» system string true The ID of the coding system that gives meaning to the code. -

ObjectiveCompletionRequests

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

ObjectiveCompletionRequest

Name Type Required Description Accepted Values
id string true The ID of the objective completion request. -
consumer ObjectiveCompletionRequestConsumerReference true The consumer who requested to complete the objective. -
objective ObjectiveCompletionRequestObjectiveReference true The objective to be completed. -
activity Activity true The details of the activity used to complete the objective. -
status string true The status of the objective completion request. Currently, the following statuses are supported:
- PENDING: Indicates that the objective completion request has not been reviewed by an administrator.
- APPROVED: Indicates that the objective completion request was reviewed and approved by an administrator.
- DENIED: Indicates that the objective completion request was reviewed and denied by an administrator.
PENDING, APPROVED, DENIED
updatedAt string true The time when the objective completion request was last updated. In ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -
proofOfObjectiveCompletions [ProofOfObjectiveCompletionMetadata] false The associated file or files used as proof for the completion of the objective. -

ObjectiveCompletionRequestConsumerReference

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

ObjectiveCompletionRequestObjectiveReference

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

Activity

Name Type Required Description Accepted Values
performedAt string true The date on which the objective is completed. The expected format is ISO 8601 YYYY-MM-DD. -
name string false The name of the activity. -
fields ActivityField false Custom attributes for an activity, for example, Provider Name or Provider Location. Up to three fields can be provided per request. -

ActivityField

Name Type Required Description Accepted Values
id string true The ID of the objective completion request form field associated with this data. -
value string true The content of the information provided by the consumer in the associated field. -

ProofOfObjectiveCompletionMetadata

Name Type Required Description Accepted Values
id string true The ID of the proof of objective completion. -
name string true The name of the file used in the proof of objective completion. -
description string false The description of the file used in the proof of objective completion. -
uploadedAt string true The time when the proof was uploaded. In ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -

postObjectiveCompletionRequests

Name Type Required Description Accepted Values
consumer object true The consumer who requested to complete the objective. -
» id string true The ID of the HealtheIntent consumer. -
objective object true The objective to be completed. -
» id string true The ID of the objective. -
activity object true The details of the activity used to complete the objective. -
» performedAt string true The date on which the objective is completed. The expected format is ISO 8601 YYYY-MM-DD. -
» name string false The name of the activity. -
» fields [object] false Custom attributes for an activity, for example, Provider Name or Provider Location. Up to three fields can be provided per request. -
»» id string true The ID of the objective completion request form field associated with this data. -
»» value string true The content of the information provided by the consumer in the associated field. -
status string false The status of the objective completion request. Currently, the following statuses are supported:
- PENDING: Indicates that the objective completion request has not been reviewed by an administrator.
- APPROVED: Indicates that the objective completion request was reviewed and approved by an administrator.
- DENIED: Indicates that the objective completion request was reviewed and denied by an administrator.
-
proofOfObjectiveCompletions [object] false A list of the associated proof of objective completions related to the objective completion request. -
» id string true The ID of the proof of objective completion. -

putObjectiveCompletionRequests

Name Type Required Description Accepted Values
consumer object true The consumer who requested to complete the objective. -
» id string true The ID of the HealtheIntent consumer. -
objective object true The objective to be completed. -
» id string true The ID of the objective. -
activity object true The details of the activity used to complete the objective. -
» performedAt string true The date on which the objective is completed. The expected format is ISO 8601 YYYY-MM-DD. -
» name string false The name of the activity. -
» fields [object] false Custom attributes for an activity, for example, Provider Name or Provider Location. Up to three fields can be provided per request. -
»» id string true The ID of the objective completion request form field associated with this data. -
»» value string true The content of the information provided by the consumer in the associated field. -
status string false The status of the objective completion request. Currently, the following statuses are supported:
- PENDING: Indicates that the objective completion request has not been reviewed by an administrator.
- APPROVED: Indicates that the objective completion request was reviewed and approved by an administrator.
- DENIED: Indicates that the objective completion request was reviewed and denied by an administrator.
-
proofOfObjectiveCompletions [object] false A list of the associated proof of objective completions related to the objective completion request. -
» id string true The ID of the proof of objective completion. -

postObjectiveCompletionRequestsObjectivecompletionrequestidReviews

Name Type Required Description Accepted Values
status string true The status of the review. The following statuses are supported:
- APPROVED: Indicates that the objective completion request was approved.
- DENIED: Indicates that the objective completion request was denied.
APPROVED, DENIED
reason string true The reason that the objective completion was denied. This field is required if the status value is DENIED. -

ObjectiveCompletionReview

Name Type Required Description Accepted Values
id string true The ID of the objective completion review. -
status string true The status of the review. The following statuses are supported:
- APPROVED: Indicates that the objective completion request was approved.
- DENIED: Indicates that the objective completion request was denied.
APPROVED, DENIED
reason string false The reason that the objective completion was denied. This field is required if the status value is DENIED. -
createdAt string true The time when the review was created. In ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -

ObjectiveCompletionReviews

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

putObjectiveCompletionRequestsObjectivecompletionrequestidReviews

Name Type Required Description Accepted Values
status string true The status of the review. The following statuses are supported:
- APPROVED: Indicates that the objective completion request was approved.
- DENIED: Indicates that the objective completion request was denied.
APPROVED, DENIED
reason string true The reason that the objective completion was denied. This field is required if the status value is DENIED. -

ProofOfObjectiveCompletions

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

ProofOfObjectiveCompletion

Name Type Required Description Accepted Values
id string true The ID of the proof of objective completion. -
name string true The name of the file used in the proof of objective completion. -
description string false The description of the file used in the proof of objective completion. -
consumer ObjectiveCompletionRequestConsumerReference true The consumer who completed the objective. -
uploadedAt string true The time when the proof was uploaded. In ISO 8601 YYYY-MM-DDThh:mm:ss.SSSZ format. -

postProofOfObjectiveCompletions

Name Type Required Description Accepted Values
name string true The name of the file used in the proof of objective completion. -
consumerId string true The consumer who requested to complete the objective. -
description string false The description of the file used in the proof of objective completion. -
file file true The file used as evidence for the proof of objective completion. The accepted content types are application/pdf, image/png, and image/jpeg. -

PhaResponseDefinitionReference

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

PhaResponseSectionReference

Name Type Required Description Accepted Values
id string true The ID of the PHA response section. -

PhaResponseSubsectionReference

Name Type Required Description Accepted Values
id string true The ID of the PHA response subsection. -