Procedure
Overview
The Procedure resource returns current and historical procedures performed on a patient. A procedure can be invasive or noninvasive treatments or procedures and observations. For example, a patient who has breast cancer could have significant and pertinent procedures that include mammograms, BRCA testing, breast examination documentation, and lumpectomy. The user decides what procedures are clinically significant to document. Surgical and radiology procedures documented in other Oracle Cerner products are returned if manually added by a clinician in the patient’s procedure history.
The following fields are returned if valued:
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.
Terminology Bindings
Procedure.code |
|
Procedure.performer.role |
|
Search
Search for procedures that meet supplied query parameters.
GET /Procedure?:parameters
Notes
- The Procedure.notPerformed modifier element is not supported and not returned.
Authorization Types
Parameters
Name | Required? | Type | Description |
---|---|---|---|
_id |
Conditionally | token |
The logical resource ID associated with the resource. This parameter is required if patient or subject is not used. Example: _id=7891
|
patient |
Conditionally | reference |
Who the procedure is for. This parameter is required if _id or subject is not used. Example: 12345
|
subject |
Conditionally | reference |
Who the procedure is for. This parameter is required if _id or patient is not used. Example: subject=Patient/12345 or subject:Patient=12345
|
date |
No | dateTime |
The date and time when the procedure’s performedDateTime was performed. Must use the ge or le prefix, or both prefixes. Example: date=le2017-02-01T10:30:00Z
|
Notes:
- The
date
parameter:- Must have a time, may be provided up to two times, and must use the
ge
orle
prefixes. - When provided twice, the lower value must have the
ge
prefix and the higher value must have thele
prefix.
- Must have a time, may be provided up to two times, and must use the
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"
}
}
}
]
}
Retrieve by ID
List an individual procedure by its ID.
GET /Procedure/:id
Notes
- The Procedure.notPerformed modifier element is not supported and not 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"
}
}