Immunization

Overview

The Immunization resource describes the event of a patient being administered a vaccine or a record of an immunization as reported by a patient, a clinician or another party. At it`s minimum, Immunization contains vaccine code, date, reference to the patient and status of the immunization, but may also contain data about the administered vaccine including the manufacturer, lot number and expiration date.

Each Immunization has next elements:

• a status
• a vaccine code that identifies the kind of vaccine administered
• a date the vaccine was administered
• a patient

Each Immunization must support: - a statusReason if the vaccine wasn’t given

Profile specific implementation guidance:

• Use the status code: not-done to represent that an immunization was not given.
• NDC codes as a translational data element: Based upon the ONC Certification Criteria for Health IT Requirements, CVX vaccine codes are required and the NDC vaccine codes SHOULD be supported as translations to them. A NDC to CVX ConceptMap is provided and is based upon the CDC’s CVX crosswalk table. A translation is illustrated in the example below.

This resource conforms to USCDI V1 profile for Immunization - refer to StructureDefinition US Core Immunization. Immunization response will be provided in JSON (refers to Capability Statement) format as per FHIR standard R4 version.

Must support elements, mandatory and optional search parameters

Immunization must support these elements:

• status
• statusReason
• vaccineCode
• patient
• occurrence[x]
• primarySource

The following search parameters and search parameter combinations SHALL be supported:

The syntax used to describe the interactions is described here.

SHALL support searching for all immunizations for a patient using the patient search parameter:

GET [base url]/Immunization?patient={Type/}[id]

The following search parameters and search parameter combinations SHOULD be supported: SHOULD support searching using the combination of the patient and date search parameters:

• including support for these date comparators: gt,lt,ge,le
• including optional support for AND search on date (e.g.date=[date]&date=[date]]&...)

GET [base url]/Immunization?patient={Type/}[id]&date=[date]

SHOULD support searching using the combination of the patient and status search parameters:

GET [base url]/Immunization?patient={Type/}[id]&status={system|}[code]

The response to any search operation is always a list of resources in a Bundle or an Operation Outcome.

Immunization By Patient Id

Search for immunizations by patient id.

METHOD GET

[base url]/Immunization?patient={Type/}[id]

PARAMS

• [base url] - FHIR base url
• [id] - Id for the Patient

HEADERS

The Authorization token SHALL be obtained during Authentication and Authorization process. Goto Authentication and Authorization for further details.

RESPONSES

EXAMPLE:

curl --location --request GET 'https://demo.kodjin.com/fhir/Immunization?patient=Patient/c5137fa5-3216-b12a-cbbc-a0c6bef361g7' \
--header 'Authorization: Bearer fe1cd986-1ac7-4c26-b8b3-d632a48408fd'

Immunization By Id

Get Immunization by ID.

METHOD GET

[base url]/Immunization/{id}

or

[base url]/Immunization?_id={id}

PARAMS

• [base url] - FHIR base url
• {id} - Id of Immunization resource

HEADERS

The Authorization token SHALL be obtained during Authentication and Authorization process. Goto Authentication and Authorization for further details.

RESPONSES

EXAMPLE:

curl --location --request GET 'https://demo.kodjin.com/fhir/Immunization/c5137fa5-3216-b12a-cbbc-a0c6bef361g7' \
--header 'Authorization: Bearer fe1cd986-1ac7-4c26-b8b3-d632a48408fd'

Immunization By patient and date search parameters

Get Immunization by combination of the patient and date search parameters.

METHOD GET

[base url]/Immunization/patient=[reference]&date={gt|lt|ge|le}[date]{&date={gt|lt|ge|le}[date]&...}

PARAMS

• [base url] - FHIR base url
• [reference] - reference to the Patient
• [date] - immunization date

HEADERS

The Authorization token SHALL be obtained during Authentication and Authorization process. Goto Authentication and Authorization for further details.

RESPONSES

EXAMPLE:

curl --location --request GET 'https://demo.kodjin.com/fhir/Immunization/patient=1137192&date=ge2019-01-14' \
--header 'Authorization: Bearer fe1cd986-1ac7-4c26-b8b3-d632a48408fd'

Immunization by patient and status search parameters

Get Immunization by combination of the patient and status search parameters.

METHOD GET

[base url]/Immunization/patient=[reference]&status={system|}[code]

PARAMS

• [base url] - FHIR base url
• [reference] - reference to the Patient
• {system|} - terminology system used to define immunization status code
• [code] - status of immunization

HEADERS

The Authorization token SHALL be obtained during Authentication and Authorization process. Goto Authentication and Authorization for further details.

RESPONSES

EXAMPLE:

curl --location --request GET 'https://demo.kodjin.com/fhir/Immunization/patient=1137192&status=completed' \
--header 'Authorization: Bearer fe1cd986-1ac7-4c26-b8b3-d632a48408fd'