NAV Navbar
Logo cerner
Ruby Shell

Immunization API v1

The HealtheIntent Immunization API allows systems to interact with immunization data in HealtheIntent.

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

URL: https://cernerdemo.api.us.healtheintent.com/immunization/v1

Immunization

Immunizations are the vaccines that have been administered to a patient. Immunizations data can include information about the administration, documentation about why a vaccine was not given, and patient statements or inferences that the vaccine was administered previously. The API sends all immunizations for a patient that are known in HealtheIntent.

Retrieve a Single Immunization

Example Request:


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

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

result = HTTParty.get('https://cernerdemo.api.us.healtheintent.com/immunization/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/d4c283a6-1a5c-4427-82ce-ef4ef8e35d30/immunizations/922335064680677580716e7c2f791facb99c67ad147fc3fe34b61b1b56ac3fcac762ed2f7f75c80aef3', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us.healtheintent.com/immunization/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/d4c283a6-1a5c-4427-82ce-ef4ef8e35d30/immunizations/922335064680677580716e7c2f791facb99c67ad147fc3fe34b61b1b56ac3fcac762ed2f7f75c80aef3 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "code": {
    "codings": [
      {
        "code": "111",
        "display": "influenza virus vaccine, live, attenuated, for intranasal use",
        "system": "2.16.840.1.113883.12.292"
      },
      {
        "code": "47260",
        "display": "influenza virus vaccine, live",
        "system": "2.16.840.1.113883.6.312"
      },
      {
        "code": "INFLUENZA_VAC",
        "display": "Influenza",
        "system": "640EB34417794175B22A9F9951A81E26"
      }
    ],
    "sourceCodings": [
      {
        "code": "2820756",
        "display": "influenza virus vaccine, live",
        "system": "urn:cerner:coding:codingsystem:codeset:72"
      },
      {
        "code": "47260",
        "display": "influenza virus vaccine, live",
        "system": "2.16.840.1.113883.6.312"
      }
    ],
    "text": "influenza virus vaccine, live"
  },
  "date": "2013-03-21",
  "dose": {
    "unit": {
      "codings": [
        {
          "code": "258773002",
          "display": "mL",
          "system": "2.16.840.1.113883.6.96"
        }
      ],
      "sourceCodings": [
        {
          "code": "293",
          "display": "mL",
          "system": "urn:cerner:coding:codingsystem:codeset:54"
        }
      ],
      "text": "mL"
    },
    "value": "0.5"
  },
  "encounter": {
    "id": "7cd017ef-7d31-390e-b4fe-52d9f86e517e"
  },
  "given": true,
  "id": "e6ca33a808884274f609b5ae4d5f77c71a1b0b7d3f1d071c2acb78e18c1e6d56",
  "lot": "M67951",
  "manufacturer": {
    "codings": [
      {
        "code": "PFR",
        "display": "Pfizer, Inc",
        "system": "2.16.840.1.114222.4.11.826"
      }
    ],
    "sourceCodings": [
      {
        "code": "3630277",
        "display": "JDB Healthcare",
        "system": "urn:cerner:coding:codingsystem:codeset:221"
      }
    ],
    "text": "JDB Healthcare"
  },
  "notes": [
    {
      "author": {
        "aliases": [
          {
            "system": "2.16.840.1.113883.4.814",
            "type": "DEA",
            "value": "1234"
          }
        ],
        "date": "2018-01-23",
        "name": {
          "formatted": "Brizendine, Margaret"
        }
      },
      "text": "Patient is feeling well today."
    }
  ],
  "reasonNotGiven": {
    "codings": [
      {}
    ],
    "sourceCodings": [
      {}
    ]
  },
  "route": {
    "codings": [
      {
        "code": "78421000",
        "display": "Intramuscular route",
        "system": "2.16.840.1.113883.6.96"
      }
    ],
    "sourceCodings": [
      {
        "code": "78421000",
        "display": "Intramuscular route",
        "system": "2.16.840.1.113883.6.96"
      }
    ],
    "text": "Intramuscular route"
  },
  "sourceIdentifier": {
    "dataPartitionId": "54dd3f9e-7c45-413d-88bc-3bafcee8b7ab",
    "id": "12345"
  },
  "status": {
    "codings": [
      {
        "code": "255594003",
        "display": "Complete (qualifier value)",
        "system": "2.16.840.1.113883.6.96"
      }
    ],
    "sourceCodings": [
      {
        "code": "255594003",
        "display": "Complete (qualifier value)",
        "system": "2.16.840.1.113883.6.96"
      }
    ],
    "text": "Complete (qualifier value)"
  }
}

GET /populations/{populationId}/patients/{patientId}/immunizations/{immunizationId}

Retrieves a single immunization for a given patient.

Parameters

Parameter In Type Required Default Description Accepted Values
patientId path string true N/A The identifier of the patient. -
populationId path string true N/A The identifier of the population. -
immunizationId path string true N/A The ID that uniquely identifies the immunization for the patient. -

Response Statuses

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

Retrieve a List of Immunizations

Example Request:


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

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

result = HTTParty.get('https://cernerdemo.api.us.healtheintent.com/immunization/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/d4c283a6-1a5c-4427-82ce-ef4ef8e35d30/immunizations', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us.healtheintent.com/immunization/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/d4c283a6-1a5c-4427-82ce-ef4ef8e35d30/immunizations \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "code": {
        "codings": [
          {
            "code": "111",
            "display": "influenza virus vaccine, live, attenuated, for intranasal use",
            "system": "2.16.840.1.113883.12.292"
          },
          {
            "code": "47260",
            "display": "influenza virus vaccine, live",
            "system": "2.16.840.1.113883.6.312"
          },
          {
            "code": "INFLUENZA_VAC",
            "display": "Influenza",
            "system": "640EB34417794175B22A9F9951A81E26"
          }
        ],
        "sourceCodings": [
          {
            "code": "2820756",
            "display": "influenza virus vaccine, live",
            "system": "urn:cerner:coding:codingsystem:codeset:72"
          },
          {
            "code": "47260",
            "display": "influenza virus vaccine, live",
            "system": "2.16.840.1.113883.6.312"
          }
        ],
        "text": "influenza virus vaccine, live"
      },
      "date": "2013-03-21",
      "dose": {
        "unit": {
          "codings": [
            {
              "code": "258773002",
              "display": "mL",
              "system": "2.16.840.1.113883.6.96"
            }
          ],
          "sourceCodings": [
            {
              "code": "293",
              "display": "mL",
              "system": "urn:cerner:coding:codingsystem:codeset:54"
            }
          ],
          "text": "mL"
        },
        "value": "0.5"
      },
      "encounter": {
        "id": "7cd017ef-7d31-390e-b4fe-52d9f86e517e"
      },
      "given": true,
      "id": "e6ca33a808884274f609b5ae4d5f77c71a1b0b7d3f1d071c2acb78e18c1e6d56",
      "lot": "M67951",
      "manufacturer": {
        "codings": [
          {
            "code": "PFR",
            "display": "Pfizer, Inc",
            "system": "2.16.840.1.114222.4.11.826"
          }
        ],
        "sourceCodings": [
          {
            "code": "3630277",
            "display": "JDB Healthcare",
            "system": "urn:cerner:coding:codingsystem:codeset:221"
          }
        ],
        "text": "JDB Healthcare"
      },
      "notes": [
        {
          "author": {
            "aliases": [
              {
                "system": "2.16.840.1.113883.4.814",
                "type": "DEA",
                "value": "1234"
              }
            ],
            "date": "2018-01-23",
            "name": {
              "formatted": "Brizendine, Margaret"
            }
          },
          "text": "Patient is feeling well today."
        }
      ],
      "reasonNotGiven": {
        "codings": [
          {}
        ],
        "sourceCodings": [
          {}
        ]
      },
      "route": {
        "codings": [
          {
            "code": "78421000",
            "display": "Intramuscular route",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "sourceCodings": [
          {
            "code": "78421000",
            "display": "Intramuscular route",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "text": "Intramuscular route"
      },
      "sourceIdentifier": {
        "dataPartitionId": "54dd3f9e-7c45-413d-88bc-3bafcee8b7ab",
        "id": "12345"
      },
      "status": {
        "codings": [
          {
            "code": "255594003",
            "display": "Complete (qualifier value)",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "sourceCodings": [
          {
            "code": "255594003",
            "display": "Complete (qualifier value)",
            "system": "2.16.840.1.113883.6.96"
          }
        ],
        "text": "Complete (qualifier value)"
      }
    }
  ],
  "firstLink": "https://cernerdemo.api.us.healtheintent.com/immunization/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/37bad71c-9276-4f55-b54d-f0491f2bb777/immunizations?limit=20",
  "nextLink": "https://cernerdemo.api.us.healtheintent.com/immunization/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/37bad71c-9276-4f55-b54d-f0491f2bb777/immunizations?cursor=e6ca33a808884274f609b5ae4d5f77c71a1b0b7d3f1d071c2acb78e18c1e6d56&limit=20"
}

GET /populations/{populationId}/patients/{patientId}/immunizations

Retrieves a list of the immunizations for a given patient.

Parameters

Parameter In Type Required Default Description Accepted Values
patientId path string true N/A The identifier of the patient. -
populationId path string true N/A The identifier of the population. -
cursor query string false N/A The last item on the list in the response from the previous request. If you specify this parameter, the response begins with the next item on the list. -
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 Immunizations
400 Bad Request Bad request Error
401 Unauthorized Unauthorized Error
403 Forbidden Forbidden Error
404 Not Found Not found Error

Schema Definitions

Immunization

Name Type Required Description Accepted Values
code CodeableConcept false The vaccine or product that was or was not given to the patient. For example, the immunization can be described by a CVX (CDC vaccines administered), CPT, RxNorm, National Drug Code (NDC), or Multum code or a HealtheIntent ontological concept. -
date string false The date and time the immunization was administered, or the date and time the immunization was planned to be administered but was not given (for example, if it was refused or contraindicated). In International Organization for Standardization (ISO) 8601 formatting with precision ranging from YYYY to YYYY-MM-DDThh:mm:ss.SSSZ. -
dose Dose false The quantity of the administered immunization dose. -
encounter Encounter false The encounter associated with the immunization. -
given boolean true Indicates whether the vaccine was administered. -
id string true The unique ID of the immunization record. -
lot string false The lot number of the drug or vaccine administered. -
manufacturer CodeableConcept false The organization that was responsible for making or producing the vaccine. For example, the manufacturer can be represented by a MVX code. -
notes [ProviderNote] true The notes or comments associated with the immunization. -
reasonNotGiven CodeableConcept false Indicates the reason the immunization was not given, for example, contraindicated or refused. -
route CodeableConcept false How the vaccine entered the body, for example, oral or intramuscular. -
sourceIdentifier SourceIdentifier false An ID that uniquely identifies this immunization for a patient in a data partition. -
status CodeableConcept false The state of the immunization record, such as completed or entered in error. -

CodeableConcept

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

Code

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

Dose

Name Type Required Description Accepted Values
unit CodeableConcept false The unit of measure associated with the dose quantity, such as mg. -
value string false The quantity or amount of the vaccine that was administered. -

Encounter

Name Type Required Description Accepted Values
id string false The unique ID of the encounter. -

ProviderNote

Name Type Required Description Accepted Values
date string false The date when the note was recorded. This field can have precision ranging from YYYY to YYYY-MM-DDThh:mm:ss.SSSZ. -
text string false The textual content of the note or comment. -
author Provider false Provider who recorded the note or comment. -

Provider

Name Type Required Description Accepted Values
aliases [ProviderAlias] false A list of identifiers of the provider, such as the ten-digit National Provider Identifier (NPI) of the provider or the Drug Enforcement Administration (DEA) number of the provider. -
name ProviderName false The name of the provider. -

ProviderAlias

Name Type Required Description Accepted Values
system string false Authority responsible for assigning the identifier. -
value string false The value or identifier within the context of the assigning authority. -
type string false The type of alias. DEA, EXTERNAL, NPI, SL, TAX, UPIN

ProviderName

Name Type Required Description Accepted Values
prefix string false The prefix portion of the provider’s name; such as Mr., Mrs., Dr., etc. -
given [string] false A list of given name portions of the provider’s name. If a person has a first name and a middle name, the first name should be the first item in the list and the middle name should be the second item in the list. -
family [string] false A list of family (i.e. last) name portions of the provider’s name. Some may have multiple family names. -
suffix string false The suffix portion of the provider’s name; such as Jr., Sr., MD., RN., etc. -
formatted string false The fully formatted name. -

SourceIdentifier

Name Type Required Description Accepted Values
dataPartitionId string false The identifier of the source data partition. -
id string false The unique identifier for the entity in the data partition. -

Error

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

ErrorDetail

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

Immunizations

Name Type Required Description Accepted Values
items [Immunization] true [Retrieves a single immunization for a given patient.] -
firstLink string true The first page of results. -
nextLink string false The next page of results. -