Immunization
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.
http://hl7.org/fhir/us/core/STU3.1.1/StructureDefinition-us-core-immunization.html
In Canvas, Immunization records can be created using either the Immunization Statement Commmand or the Immunize Command.
Endpoints
Immunization read
Path Parameters
Response Payload Attributes
The FHIR Resource name.
The Canvas identifier of the immunization.
The status of the immunization.
A coding for reason not given, if recorded - omitted otherwise.
Identifies where the definition of the code comes from.
The system url of the coding.
The code.
The display name of the coding.
Coding for the administered vaccine.
Identifies where the definition of the code comes from.
The system url of the coding.
The code.
The display name of the coding.
The patient who received the immunization.
The reference string of the subject in the format of "Patient/a39cafb9d1b445be95a2e2548e12a787"
.
Type the reference refers to (e.g. “Patient”).
The date or datetime the immunization was administered or reported to have been administered.
Whether the immunization was administered by a primary source.
- true indicates that the immunization was administered within the clinic. To document immunizations like these, use an Immunize Command.
- false indicates that the immunization was administered outside the clinic. To document this immunizations like these, use an Immunization Statement Command.
Responses
Errors
Immunization search
Query Parameters
A Canvas-issued unique identifier for a specific immunization.
The patient for the vaccination record in the format Patient/a39cafb9d1b445be95a2e2548e12a787
.
Response Payload Attributes
The FHIR Resource name.
This element and value designate that the bundle is a search response. Search result bundles will always have the Bundle.type of searchset .
The number of resources that match the search parameter.
Attributes relevant to pagination, see our Pagination page for more detail.
The relation of the page search
The search url for the specific relation
The results bundle that lists out each object returned in the search
The attributes specific to the resource type, see the Attributes section below
Attributes
The FHIR Resource name.
The Canvas identifier of the immunization.
The status of the immunization.
A coding for reason not given, if recorded - omitted otherwise.
Identifies where the definition of the code comes from.
The system url of the coding.
The code.
The display name of the coding.
Coding for the administered vaccine.
Identifies where the definition of the code comes from.
The system url of the coding.
The code.
The display name of the coding.
The patient who received the immunization.
The reference string of the subject in the format of "Patient/a39cafb9d1b445be95a2e2548e12a787"
.
Type the reference refers to (e.g. “Patient”).
The date or datetime the immunization was administered or reported to have been administered.
Whether the immunization was administered by a primary source.
- true indicates that the immunization was administered within the clinic. To document immunizations like these, use an Immunize Command.
- false indicates that the immunization was administered outside the clinic. To document this immunizations like these, use an Immunization Statement Command.
Responses
Errors
curl --request GET \ --url 'https://fumage-example.canvasmedical.com/Immunization/<id>' \ --header 'Authorization: Bearer <token>' \ --header 'accept: application/json'
import requests url = "https://fumage-example.canvasmedical.com/Immunization/<id>" headers = { "accept": "application/json", "Authorization": "Bearer <token>" } response = requests.get(url, headers=headers) print(response.text)
{ "resourceType": "Immunization", "id": "d9aefede-da05-4bef-bbf9-63bcf83c806a", "status": "completed", "vaccineCode": { "coding": [ { "system": "http://hl7.org/fhir/sid/cvx", "code": "207", "display": "Moderna Severe acute respiratory syndrome coronavirus 2 (SARS-CoV-2) (coronavirus disease [COVID-19]) vaccine, mRNA-LNP, spike protein, preservative free, 50 mcg/0.25 mL dosage, for intramuscular use" } ] }, "patient": { "reference": "Patient/a1197fa9e65b4a5195af15e0234f61c2", "type": "Patient" }, "occurrenceDateTime": "2022-05-26T18:55:34.629659+00:00", "primarySource": false }
{ "resourceType": "OperationOutcome", "issue": [ { "severity": "error", "code": "unknown", "details": { "text": "Authentication failed" } } ] }
{ "resourceType": "OperationOutcome", "issue": [ { "severity": "error", "code": "forbidden", "details": { "text": "Authorization failed" } } ] }
{ "resourceType": "OperationOutcome", "issue": [ { "severity": "error", "code": "not-found", "details": { "text": "Unknown Immunization resource 'd9aefede-da05-4bef-bbf9-63bcf83c806b'" } } ] }
curl --request GET \ --url 'https://fumage-example.canvasmedical.com/Immunization?patient=Patient/4d9c4a797b8c4a58872017e7a19a474e' \ --header 'Authorization: Bearer <token>' \ --header 'accept: application/json'
import requests url = "https://fumage-example.canvasmedical.com/Immunization?patient=Patient/4d9c4a797b8c4a58872017e7a19a474e" headers = { "accept": "application/json", "Authorization": "Bearer <token>" } response = requests.get(url, headers=headers) print(response.text)
{ "resourceType": "Bundle", "type": "searchset", "total": 1, "link": [ { "relation": "self", "url": "/Immunization?patient=Patient%2F4d9c4a797b8c4a58872017e7a19a474e&_count=10&_offset=0" }, { "relation": "first", "url": "/Immunization?patient=Patient%2F4d9c4a797b8c4a58872017e7a19a474e&_count=10&_offset=0" }, { "relation": "last", "url": "/Immunization?patient=Patient%2F4d9c4a797b8c4a58872017e7a19a474e&_count=10&_offset=0" } ], "entry": [ { "resource": { "resourceType": "Immunization", "id": "d9aefede-da05-4bef-bbf9-63bcf83c806a", "status": "completed", "vaccineCode": { "coding": [ { "system": "http://hl7.org/fhir/sid/cvx", "code": "207", "display": "Moderna Severe acute respiratory syndrome coronavirus 2 (SARS-CoV-2) (coronavirus disease [COVID-19]) vaccine, mRNA-LNP, spike protein, preservative free, 50 mcg/0.25 mL dosage, for intramuscular use" } ] }, "patient": { "reference": "Patient/4d9c4a797b8c4a58872017e7a19a474e", "type": "Patient" }, "occurrenceDateTime": "2021-12-01", "primarySource": false } } ] }