Resources: DSTU2: Procedure


Procedure resource

The Procedure resource is used to retrieve a specific patient's procedures (DAF Procedure). The logical ID of the patient is passed as part of the URL. The logical ID is found as the result of a patient search.

To retrieve a patient's procedures, use the following syntax:

GET {FHIR URL}/FHIR/Patient/{ID}/Procedure

To retrieve a patient's procedures reported on January 1, 2016, use the following syntax:

GET {FHIR URL}/FHIR/Patient/{ID}/Procedure?date=eq2016-01-01

Input parameters

Name Required? Type Description
ID Yes URL The patient's logical ID. This is retrieved using the search function.
date No string A string representing a date to include in the search. See below for more information.

Output specification

Name Type Cardinality Description
identifier 0..* Procedure identifier. These identifiers are defined by business processes and/or used to refer to it when a direct URL reference to the resource itself is not appropriate (for example, in CDA documents, or in written/printed documentation).
subject Reference (Patient, Group) 1..1 Person, animal, or group on which the procedure was performed.
status code 1..1 In-progress, aborted, completed, or entered-in-error. For more information on this value set, see here.
category CodeableConcept 0..1 Classification of the procedure. For more information on this value set, see here.
code CodeableConcept 1..1 Identification code of the procedure. The value set defines a set of codes that can be used to indicate the type of procedure: a specific code indicating type of procedure performed from CPT, SNOMED CT, and ICD10-PCS. For more information on this value set, see here.
notPerformed boolean 0..1 Was the procedure not performed as scheduled? (Yes if not scheduled.)
reasonNotPerformed CodeableConcept 0..* Reason procedure was not performed. For more information on this value set, see here.
bodySite CodeableConcept 0..* Target body sites. For more information on this value set, see here.
reasonCodeableConcept CodeableConcept 0..1 Reason why the procedure was performed.
reasonReference Reference (Condition) 0..1 Reason for the procedure.
performer 0..* Individual who performed the procedure. This must be a real person, not equipment.
-- performer.actor Reference (Practitioner, Organization, Patient, RelatedPerson) 0..1 Reference to the practitioner.
-- performer.role CodeableConcept 0..1 Role the actor was in. Values come from here.
performedDateTime dateTime 0..1 Date/time period over which the procedure was performed. Allows a period to support complex procedures that span more than one date, and also allows for the length of the procedure to be captured.
performedPeriod Period 0..1 Date/time period during which the procedure was performed.
encounter Reference (Encounter) 0..1 Encounter during which the procedure was performed.
location Reference (Location) 0..1 Location where the procedure was performed.
outcome CodeableConcept 0..1 Result of the procedure. For more information on this value set, see here.
report Reference (DiagnosticReport) 0..* Any report resulting from the procedure.
complication CodeableConcept 0..* Complication following the procedure. For more information on this value set, see here.
followUp CodeableConcept 0..* Instructions for follow up. For more information on this value set, see here.
request Reference (CarePlan, DiagnosticOrder, ProcedureRequest, ReferralRequest) 0..1 Request for the procedure.
notes Annotation 0..* Additional information about the procedure.
focalDevice 0..* Device changed during the procedure.
-- focalDevice.action CodeableConcept 0..1 Kind of change to device. For more information on this value set, see here.
-- focalDevice.manipulated Reference (Device) 1..1 Device that was changed during the procedure.
used Reference (Device, Medication, Substance) 0..* Items used during the procedure.