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
  • 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

Notes

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:

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

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"
  }
}