Procedure
Overview
The Procedure resource returns current and historical procedures performed on a patient. A procedure can be invasive or non-invasive treatments/procedures and observations. For example, a patient who has breast cancer could have significant & pertinent procedures that include mammograms, BRCA testing, breast examination documentation & lumpectomy. It is up to the user what procedures are clinically significant to document. Surgical and radiology procedures documented in other Cerner solutions will return if manually added by a clinician in the patient’s procedure history.
The following fields are returned if valued:
- Procedure id
- Patient
- Status (completed, entered-in-error)
- Procedure
- Reason performed
- Who performed
- Date performed
- Patient encounter
- Notes
Terminology Bindings
Procedure.code |
|
Procedure.performer.role |
|
Search
Search for Procedures that meet supplied query parameters:
GET /Procedure?:parameters
Implementation Notes
- The Procedure.notPerformed modifier element is not supported and will not be returned.
Authorization Types
Parameters
Name | Required? | Type | Description |
---|---|---|---|
_id |
This, or one of patient or subject
|
token |
The logical resource id associated with the resource. Example: _id=7891
|
patient |
This, or one of _id or subject
|
reference |
The patient subject of the Procedure. Example: patient=12345
|
subject |
This, or one of _id or patient
|
reference |
The subject of the Procedure. Must represent a Patient resource. May use the :Patient modifier. Example: subject=Patient/12345 or subject:Patient=12345
|
date |
N | date |
The date/time when the Procedure was performed. Must use the ge and/or le prefixes. Example: date=le2017-02-01T10:30:00Z
|
Notes:
-
The
_id
parameter may not be provided at the same time as thepatient
,subject
, ordate
parameters. -
The
date
parameter must have a time, may be provided up to two times, and must use thege
orle
prefixes. When provided twice, the lower value must have thege
prefix and the higher value must have thele
prefix.
Headers
Accept: application/json+fhir
Authorization: <OAuth2 Bearer Token>
Example
Request
GET https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Procedure?patient=12724066
Response
Status: 200 OK
{
"resourceType": "Bundle",
"id": "936b19a5-9a5b-4032-96b9-ebeaf55097e1",
"type": "searchset",
"total": 2,
"link": [
{
"relation": "self",
"url": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Procedure?patient=12724066"
}
],
"entry": [
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Procedure/2572382193",
"resource": {
"resourceType": "Procedure",
"id": "2572382193",
"meta": {
"versionId": "0",
"lastUpdated": "2020-06-11T04:02:54.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Procedure</b></p><p><b>Subject</b>: SMART, NANCY</p><p><b>Code</b>: Appendectomy;</p><p><b>Status</b>: Completed</p></div>"
},
"subject": {
"reference": "Patient/12724066",
"display": "SMART, NANCY"
},
"status": "completed",
"code": {
"coding": [
{
"system": "http://www.ama-assn.org/go/cpt",
"code": "44950",
"display": "Appendectomy;"
}
],
"text": "Appendectomy;"
},
"performedDateTime": "2002",
"encounter": {
"reference": "Encounter/97953477"
}
}
},
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Procedure/2572383421",
"resource": {
"resourceType": "Procedure",
"id": "2572383421",
"meta": {
"versionId": "0",
"lastUpdated": "2020-06-16T21:09:27.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Procedure</b></p><p><b>Subject</b>: SMART, NANCY</p><p><b>Code</b>: Coronary artery bypass, using arterial graft(s); 2 coronary arterial grafts</p><p><b>Status</b>: Completed</p></div>"
},
"subject": {
"reference": "Patient/12724066",
"display": "SMART, NANCY"
},
"status": "completed",
"code": {
"coding": [
{
"system": "http://www.ama-assn.org/go/cpt",
"code": "33534",
"display": "Coronary artery bypass, using arterial graft(s); two coronary arterial grafts"
}
],
"text": "Coronary artery bypass, using arterial graft(s); 2 coronary arterial grafts"
},
"performedDateTime": "2018",
"encounter": {
"reference": "Encounter/97953477"
}
}
}
]
}
Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.
Errors
The common errors and OperationOutcomes may be returned.
Retrieve by id
List an individual Procedure by its id:
GET /Procedure/:id
Implementation Notes
- The Procedure.notPerformed modifier element is not supported and will not be returned.
Authorization Types
Headers
Accept: application/json+fhir
Authorization: <OAuth2 Bearer Token>
Example
Request
GET https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Procedure/2572382193
Response
Status: 200 OK
{
"resourceType": "Procedure",
"id": "2572382193",
"meta": {
"versionId": "0",
"lastUpdated": "2020-06-11T04:02:54.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Procedure</b></p><p><b>Subject</b>: SMART, NANCY</p><p><b>Code</b>: Appendectomy;</p><p><b>Status</b>: Completed</p></div>"
},
"subject": {
"reference": "Patient/12724066",
"display": "SMART, NANCY"
},
"status": "completed",
"code": {
"coding": [
{
"system": "http://www.ama-assn.org/go/cpt",
"code": "44950",
"display": "Appendectomy;"
}
],
"text": "Appendectomy;"
},
"performedDateTime": "2002",
"encounter": {
"reference": "Encounter/97953477"
}
}
Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.
Errors
The common errors and OperationOutcomes may be returned.