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:

Terminology Bindings

Procedure.code
  • Description
    • A code to identify a specific procedure
  • Details: Procedure Codes (SNOMED CT)
    System: http://snomed.info/sct

  • Details: CPT
    System: http://www.ama-assn.org/go/cpt

  • Details: ICD-10-PCS
    System: http://www.icd10data.com/icd10pcs

Procedure.performer.role

Search for Procedures that meet supplied query parameters:

GET /Procedure?:parameters

Implementation Notes

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:

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

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.